Class RichTextValueBuilder

RichTextValueBuilder

Builder untuk nilai Teks Kaya.

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
build()RichTextValueMembuat nilai Teks Rich dari builder ini.
setLinkUrl(startOffset, endOffset, linkUrl)RichTextValueBuilderMenetapkan URL link untuk substring tertentu dari nilai ini, atau menghapusnya jika linkUrl adalah null.
setLinkUrl(linkUrl)RichTextValueBuilderMenetapkan URL link untuk seluruh nilai, atau menghapusnya jika linkUrl adalah null.
setText(text)RichTextValueBuilderMenetapkan teks untuk nilai ini dan menghapus gaya teks yang ada.
setTextStyle(startOffset, endOffset, textStyle)RichTextValueBuilderMenerapkan gaya teks ke substring tertentu dari nilai ini.
setTextStyle(textStyle)RichTextValueBuilderMenerapkan gaya teks ke seluruh nilai.

Dokumentasi mendetail

build()

Membuat nilai Teks Rich dari builder ini.

Pulang pergi

RichTextValue — Nilai Teks Kaya yang dibuat dari builder ini.


setLinkUrl(startOffset, endOffset, linkUrl)

Menetapkan URL link untuk substring tertentu 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

NamaJenisDeskripsi
startOffsetIntegerOffset awal untuk substring, inklusif.
endOffsetIntegerOffset akhir untuk substring, eksklusif.
linkUrlStringURL link yang ditetapkan.

Pulang pergi

RichTextValueBuilder — Builder ini, untuk dirangkaikan.


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

NamaJenisDeskripsi
linkUrlStringURL link yang ditetapkan.

Pulang pergi

RichTextValueBuilder — Builder ini, untuk dirangkaikan.


setText(text)

Menetapkan teks untuk nilai ini dan menghapus gaya teks yang ada. Saat membuat nilai Teks Rich baru, metode ini harus dipanggil sebelum setTextStyle(startOffset, endOffset, textStyle).

Parameter

NamaJenisDeskripsi
textStringTeks untuk nilai ini.

Pulang pergi

RichTextValueBuilder — Builder ini, untuk dirangkaikan.


setTextStyle(startOffset, endOffset, textStyle)

Menerapkan gaya teks ke substring tertentu dari nilai ini. Offset berbasis 0 dan bersifat 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.
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const value = SpreadsheetApp.newRichTextValue()
                  .setText('HelloWorld')
                  .setTextStyle(0, 5, bold)
                  .setTextStyle(5, 10, italic)
                  .build();

Parameter

NamaJenisDeskripsi
startOffsetIntegerOffset awal untuk substring, inklusif.
endOffsetIntegerOffset akhir untuk substring, eksklusif.
textStyleTextStyleGaya teks yang sedang disetel.

Pulang pergi

RichTextValueBuilder — Builder ini, untuk dirangkaikan.


setTextStyle(textStyle)

Menerapkan gaya teks ke seluruh nilai. Gaya teks yang 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.
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const value = SpreadsheetApp.newRichTextValue()
                  .setText('HelloWorld')
                  .setTextStyle(0, 5, bold)
                  .setTextStyle(italic)
                  .build();

Parameter

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang sedang disetel.

Pulang pergi

RichTextValueBuilder — Builder ini, untuk dirangkaikan.