Class RichTextValueBuilder

RichTextValueBuilder

Builder untuk nilai Rich Text.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
build()RichTextValueMembuat nilai Teks Kaya dari builder ini.
setLinkUrl(startOffset, endOffset, linkUrl)RichTextValueBuilderMenetapkan URL link untuk substring yang diberikan 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)RichTextValueBuilderMenyetel teks untuk nilai ini dan menghapus gaya teks yang ada.
setTextStyle(startOffset, endOffset, textStyle)RichTextValueBuilderMenerapkan gaya teks ke substring yang diberikan dari nilai ini.
setTextStyle(textStyle)RichTextValueBuilderMenerapkan 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

NamaJenisDeskripsi
startOffsetIntegerOffset awal untuk substring, inklusif.
endOffsetIntegerOffset akhir untuk substring, eksklusif.
linkUrlStringURL 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

NamaJenisDeskripsi
linkUrlStringURL 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

NamaJenisDeskripsi
textStringTeks 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

NamaJenisDeskripsi
startOffsetIntegerOffset awal untuk substring, inklusif.
endOffsetIntegerOffset akhir untuk substring, eksklusif.
textStyleTextStyleGaya 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

NamaJenisDeskripsi
textStyleTextStyleGaya teks sedang ditetapkan.

Return

RichTextValueBuilder — Builder ini untuk membuat rantai.