Trình tạo giá trị Văn bản đa dạng thức.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
build() | RichTextValue | Tạo giá trị Văn bản đa dạng thức từ trình tạo này. |
setLinkUrl(startOffset, endOffset, linkUrl) | RichTextValueBuilder | Thiết lập URL liên kết cho chuỗi con đã cho của giá trị này hoặc xoá URL đó nếu linkUrl là null . |
setLinkUrl(linkUrl) | RichTextValueBuilder | Đặt URL liên kết cho toàn bộ giá trị hoặc xoá URL đó nếu linkUrl là null . |
setText(text) | RichTextValueBuilder | Đặt văn bản cho giá trị này và xoá mọi kiểu văn bản hiện có. |
setTextStyle(startOffset, endOffset, textStyle) | RichTextValueBuilder | Áp dụng một kiểu văn bản cho chuỗi con đã cho của giá trị này. |
setTextStyle(textStyle) | RichTextValueBuilder | Áp dụng một kiểu văn bản cho toàn bộ giá trị. |
Tài liệu chi tiết
build()
Tạo giá trị Văn bản đa dạng thức từ trình tạo này.
Cầu thủ trả bóng
RichTextValue
— Một giá trị Văn bản đa dạng thức được tạo từ trình tạo này.
setLinkUrl(startOffset, endOffset, linkUrl)
Thiết lập URL liên kết cho chuỗi con đã cho của giá trị này hoặc xoá URL đó nếu linkUrl
là null
.
// Creates a Rich Text value for the text "foo no baz" with "foo" pointing to // "https://bar.foo" and "baz" to "https://abc.xyz". // "foo" is underlined with the default link color, whereas "baz" has its text style // overridden by a call to `setTextStyle`, and is therefore black and bold with no underlining. const boldStyle = SpreadsheetApp.newTextStyle() .setUnderline(false) .setBold(true) .setForegroundColor("#000000") .build(); const value = SpreadsheetApp.newRichTextValue() .setText("foo no baz") .setLinkUrl(0, 3, "https://bar.foo") .setLinkUrl(7, 10, "https://abc.xyz") .setTextStyle(7, 10, boldStyle) .build();
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startOffset | Integer | Giá trị bù trừ bắt đầu cho chuỗi con, bao gồm cả giá trị này. |
endOffset | Integer | Phần bù trừ cuối của chuỗi con, không bao gồm. |
linkUrl | String | URL liên kết đang được đặt. |
Cầu thủ trả bóng
RichTextValueBuilder
– Trình tạo này để tạo chuỗi.
setLinkUrl(linkUrl)
Đặt URL liên kết cho toàn bộ giá trị hoặc xoá URL đó nếu linkUrl
là null
.
// Creates a Rich Text value for the text "Foo" which points to "https://bar.foo". const value = SpreadsheetApp.newRichTextValue() .setText("Foo") .setLinkUrl("https://bar.foo") .build();
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
linkUrl | String | URL liên kết đang được đặt. |
Cầu thủ trả bóng
RichTextValueBuilder
– Trình tạo này để tạo chuỗi.
setText(text)
Đặt văn bản cho giá trị này và xoá mọi kiểu văn bản hiện có. Khi tạo một giá trị Văn bản đa dạng thức mới, giá trị này phải được gọi trước setTextStyle(startOffset, endOffset, textStyle)
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | Văn bản cho giá trị này. |
Cầu thủ trả bóng
RichTextValueBuilder
– Trình tạo này để tạo chuỗi.
setTextStyle(startOffset, endOffset, textStyle)
Áp dụng một kiểu văn bản cho chuỗi con đã cho của giá trị này. Độ lệch bằng 0 và tương đối với giá trị văn bản của ô. Không làm gì nếu textStyle
là null
.
// Creates a Rich Text value for the text "HelloWorld", with "Hello" bolded, and "World" // italicized. var bold = SpreadsheetApp.newTextStyle().setBold(true).build(); var italic = SpreadsheetApp.newTextStyle().setItalic(true).build(); var value = SpreadsheetApp.newRichTextValue() .setText("HelloWorld") .setTextStyle(0, 5, bold) .setTextStyle(5, 10, italic) .build();
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startOffset | Integer | Giá trị bù trừ bắt đầu cho chuỗi con, bao gồm cả giá trị này. |
endOffset | Integer | Phần bù trừ cuối của chuỗi con, không bao gồm. |
textStyle | TextStyle | Kiểu văn bản đang được đặt. |
Cầu thủ trả bóng
RichTextValueBuilder
– Trình tạo này để tạo chuỗi.
setTextStyle(textStyle)
Áp dụng một kiểu văn bản cho toàn bộ giá trị. Các kiểu văn bản đã thiết lập trước đó chỉ bị ảnh hưởng nếu bị ghi đè trực tiếp bằng các giá trị trong textStyle
. Không có tác dụng gì nếu textStyle
là null
.
// Creates a Rich Text value for the text "HelloWorld" with "Hello" bolded and italicized, // and "World" only italicized. var bold = SpreadsheetApp.newTextStyle().setBold(true).build(); var italic = SpreadsheetApp.newTextStyle().setItalic(true).build(); var value = SpreadsheetApp.newRichTextValue() .setText("HelloWorld") .setTextStyle(0, 5, bold) .setTextStyle(italic) .build();
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
textStyle | TextStyle | Kiểu văn bản đang được đặt. |
Cầu thủ trả bóng
RichTextValueBuilder
– Trình tạo này để tạo chuỗi.