Builder untuk nilai Rich Text.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
build() | RichTextValue | Membuat nilai Teks Kaya dari builder ini. |
setLinkUrl(startOffset, endOffset, linkUrl) | RichTextValueBuilder | Menetapkan URL link untuk substring yang diberikan dari nilai ini, atau menghapusnya jika linkUrl adalah
null . |
setLinkUrl(linkUrl) | RichTextValueBuilder | Menetapkan URL link untuk seluruh nilai, atau menghapusnya jika linkUrl adalah null . |
setText(text) | RichTextValueBuilder | Menyetel teks untuk nilai ini dan menghapus gaya teks yang ada. |
setTextStyle(startOffset, endOffset, textStyle) | RichTextValueBuilder | Menerapkan gaya teks ke substring yang diberikan dari nilai ini. |
setTextStyle(textStyle) | RichTextValueBuilder | Menerapkan gaya teks ke seluruh nilai. |
Dokumentasi mendetail
build()
Membuat nilai Teks Kaya dari builder ini.
Return
RichTextValue
— Nilai Rich Text yang dibuat dari builder ini.
setLinkUrl(startOffset, endOffset, linkUrl)
Menetapkan URL link untuk substring yang diberikan dari nilai ini, atau menghapusnya jika linkUrl
adalah
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();
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
startOffset | Integer | Offset awal untuk substring, inklusif. |
endOffset | Integer | Offset akhir untuk substring, eksklusif. |
linkUrl | String | URL link sedang ditetapkan. |
Return
RichTextValueBuilder
— Builder ini untuk membuat rantai.
setLinkUrl(linkUrl)
Menetapkan URL link untuk seluruh nilai, atau menghapusnya jika linkUrl
adalah 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();
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
linkUrl | String | URL link sedang ditetapkan. |
Return
RichTextValueBuilder
— Builder ini untuk membuat rantai.
setText(text)
Menyetel teks untuk nilai ini dan menghapus gaya teks yang ada. Saat membuat nilai Teks Kaya baru, nilai ini harus dipanggil sebelum setTextStyle(startOffset, endOffset, textStyle)
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Teks untuk nilai ini. |
Return
RichTextValueBuilder
— Builder ini untuk membuat rantai.
setTextStyle(startOffset, endOffset, textStyle)
Menerapkan gaya teks ke substring yang diberikan dari nilai ini. Offset berbasis 0 dan relatif
terhadap nilai teks sel. Tidak melakukan apa pun jika textStyle
adalah 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();
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
startOffset | Integer | Offset awal untuk substring, inklusif. |
endOffset | Integer | Offset akhir untuk substring, eksklusif. |
textStyle | TextStyle | Gaya teks sedang ditetapkan. |
Return
RichTextValueBuilder
— Builder ini untuk membuat rantai.
setTextStyle(textStyle)
Menerapkan gaya teks ke seluruh nilai. Gaya teks yang telah ditetapkan sebelumnya hanya terpengaruh jika
ditimpa secara langsung oleh nilai dalam textStyle
. Tidak melakukan apa pun jika textStyle
adalah 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();
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
textStyle | TextStyle | Gaya teks sedang ditetapkan. |
Return
RichTextValueBuilder
— Builder ini untuk membuat rantai.