Class RichTextValueBuilder

TekstsformatowanywartośćBuilder

Kreator wartości sformatowanego tekstu.

Metody

MetodaZwracany typKrótki opis
build()RichTextValueTworzy wartość sformatowanego tekstu z tego kreatora.
setLinkUrl(startOffset, endOffset, linkUrl)RichTextValueBuilderUstawia adres URL linku dla podanego podciągu tej wartości lub czyści go, jeśli linkUrl jest ustawiony na null.
setLinkUrl(linkUrl)RichTextValueBuilderUstawia adres URL linku dla całej wartości lub usuwa go, jeśli linkUrl to null.
setText(text)RichTextValueBuilderUstawia tekst dla tej wartości i wyczyści dotychczasowy styl tekstu.
setTextStyle(startOffset, endOffset, textStyle)RichTextValueBuilderStosuje styl tekstu do podanego podciągu tej wartości.
setTextStyle(textStyle)RichTextValueBuilderStosuje styl tekstu do całej wartości.

Szczegółowa dokumentacja

build()

Tworzy wartość sformatowanego tekstu z tego kreatora.

Powrót

RichTextValue – wartość sformatowanego tekstu utworzona w tym kreatorze.

setLinkUrl(startOffset, endOffset, linkUrl)

Ustawia adres URL linku dla podanego podciągu tej wartości lub czyści go, jeśli linkUrl jest ustawiony na 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();

Parametry

NazwaTypOpis
startOffsetIntegerPrzesunięcie początkowe podciągu, włącznie z tym punktem.
endOffsetIntegerOdsunięcie końcowe podciągu (wyłącznie).
linkUrlStringAdres URL linku, który jest ustawiany.

Powrót

RichTextValueBuilder – ten kreator do łańcuchowania.

setLinkUrl(linkUrl)

Ustawia adres URL linku dla całej wartości lub usuwa go, jeśli linkUrl to 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();

Parametry

NazwaTypOpis
linkUrlStringAdres URL linku, który jest ustawiany.

Powrót

RichTextValueBuilder – ten kreator do łańcuchowania.

setText(text)

Ustawia tekst dla tej wartości i wyczyści dotychczasowy styl tekstu. Podczas tworzenia nowej wartości tekstu zwykłego należy wywołać tę metodę przed wywołaniem metody setTextStyle(startOffset, endOffset, textStyle).

Parametry

NazwaTypOpis
textStringTekst tej wartości.

Powrót

RichTextValueBuilder – ten kreator do łańcuchowania.

setTextStyle(startOffset, endOffset, textStyle)

Stosuje styl tekstu do podanego podciągu tej wartości. Odchyłki są obliczane względem 0 i są względne do wartości tekstowej komórki. Nie robi nic, jeśli textStyle ma wartość 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();

Parametry

NazwaTypOpis
startOffsetIntegerPrzesunięcie początkowe podciągu, włącznie z tym punktem.
endOffsetIntegerOdsunięcie końcowe podciągu (wyłącznie).
textStyleTextStyleUstawiany styl tekstu.

Powrót

RichTextValueBuilder – ten kreator do łańcuchowania.

setTextStyle(textStyle)

Stosuje styl tekstu do całej wartości. Wcześniej ustawione style tekstu są modyfikowane tylko wtedy, gdy wartości w sekcji textStyle zastępują je bezpośrednio. Nic nie robi, jeśli textStyle jest 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();

Parametry

NazwaTypOpis
textStyleTextStyleUstawiany styl tekstu.

Powrót

RichTextValueBuilder – ten kreator do łańcuchowania.