Class RichTextValueBuilder

RichTextValueBuilder

Builder untuk nilai Rich Text.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
build()RichTextValueMembuat nilai Rich Text dari builder ini.
setLinkUrl(startOffset, endOffset, linkUrl)RichTextValueBuilderMenetapkan URL link untuk substring yang diberikan pada 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 yang diberikan pada nilai ini.
setTextStyle(textStyle)RichTextValueBuilderMenerapkan gaya teks ke seluruh nilai.

Dokumentasi mendetail

build()

Membuat nilai Rich Text dari builder ini.

Return

RichTextValue — Nilai Rich Text yang dibuat dari builder ini.


setLinkUrl(startOffset, endOffset, linkUrl)

Menetapkan URL link untuk substring yang diberikan pada 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

NameJenisDeskripsi
startOffsetIntegerOffset awal untuk substring, inklusif.
endOffsetIntegerOffset akhir untuk substring, eksklusif.
linkUrlStringURL link sedang ditetapkan.

Return

RichTextValueBuilder — Builder ini, untuk 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

NameJenisDeskripsi
linkUrlStringURL link sedang ditetapkan.

Return

RichTextValueBuilder — Builder ini, untuk rantai.


setText(text)

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

Parameter

NameJenisDeskripsi
textStringTeks untuk nilai ini.

Return

RichTextValueBuilder — Builder ini, untuk rantai.


setTextStyle(startOffset, endOffset, textStyle)

Menerapkan gaya teks ke substring yang diberikan pada 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

NameJenisDeskripsi
startOffsetIntegerOffset awal untuk substring, inklusif.
endOffsetIntegerOffset akhir untuk substring, eksklusif.
textStyleTextStyleGaya teks yang ditetapkan.

Return

RichTextValueBuilder — Builder ini, untuk rantai.


setTextStyle(textStyle)

Menerapkan gaya teks ke seluruh nilai. Gaya teks yang ditetapkan sebelumnya hanya terpengaruh jika langsung ditimpa 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

NameJenisDeskripsi
textStyleTextStyleGaya teks yang ditetapkan.

Return

RichTextValueBuilder — Builder ini, untuk rantai.