Class RichTextValueBuilder

RichTextValueBuilder

Narzędzie do tworzenia wartości sformatowanego tekstu.

Metody

Metoda	Zwracany typ	Krótki opis
build()	RichTextValue	Tworzy wartość sformatowanego tekstu na podstawie tego narzędzia.
setLinkUrl(startOffset, endOffset, linkUrl)	RichTextValueBuilder	Ustawia adres URL linku dla danego podciągu tej wartości lub czyści go, jeśli linkUrl ma wartość null.
setLinkUrl(linkUrl)	RichTextValueBuilder	Ustawia adres URL linku dla całej wartości lub czyści go, jeśli linkUrl ma wartość null.
setText(text)	RichTextValueBuilder	Ustawia tekst dla tej wartości i czyści wszystkie istniejące style tekstu.
setTextStyle(startOffset, endOffset, textStyle)	RichTextValueBuilder	Stosuje styl tekstu do danego podciągu tej wartości.
setTextStyle(textStyle)	RichTextValueBuilder	Stosuje styl tekstu do całej wartości.

Szczegółowa dokumentacja

build()

Tworzy wartość sformatowanego tekstu na podstawie tego narzędzia.

Powrót

RichTextValue – wartość sformatowanego tekstu utworzona na podstawie tego narzędzia.

---

setLinkUrl(startOffset, endOffset, linkUrl)

Ustawia adres URL linku dla danego podciągu tej wartości lub czyści go, jeśli linkUrl ma wartość 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

Nazwa	Typ	Opis
startOffset	Integer	Przesunięcie początkowe podłańcucha (włącznie z wartościami granicznymi).
endOffset	Integer	Przesunięcie końcowe podciągu (wyłącznie).
linkUrl	String	Ustawiany adres URL linku.

Powrót

RichTextValueBuilder – to narzędzie do tworzenia łańcuchów.

---

setLinkUrl(linkUrl)

Ustawia adres URL linku dla całej wartości lub czyści go, jeśli linkUrl ma wartość 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

Nazwa	Typ	Opis
linkUrl	String	Ustawiany adres URL linku.

Powrót

RichTextValueBuilder – to narzędzie do tworzenia łańcuchów.

---

setText(text)

Ustawia tekst dla tej wartości i czyści wszystkie istniejące style tekstu. Podczas tworzenia nowej wartości sformatowanego tekstu należy wywołać tę metodę przed wywołaniem metody setTextStyle(startOffset, endOffset, textStyle).

Parametry

Nazwa	Typ	Opis
text	String	Tekst dla tej wartości.

Powrót

RichTextValueBuilder – to narzędzie do tworzenia łańcuchów.

---

setTextStyle(startOffset, endOffset, textStyle)

Stosuje styl tekstu do danego podciągu tej wartości. Przesunięcia są liczone od 0 i są względne w stosunku do wartości tekstowej komórki. Jeśli textStyle ma wartość null, ta metoda nie robi nic.

// 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

Nazwa	Typ	Opis
startOffset	Integer	Przesunięcie początkowe podłańcucha (włącznie z wartościami granicznymi).
endOffset	Integer	Przesunięcie końcowe podciągu (wyłącznie).
textStyle	TextStyle	Ustawiany styl tekstu.

Powrót

RichTextValueBuilder – to narzędzie do tworzenia łańcuchów.

---

setTextStyle(textStyle)

Stosuje styl tekstu do całej wartości. Wcześniej ustawione style tekstu są zmieniane tylko wtedy, gdy są bezpośrednio zastępowane przez wartości w textStyle. Jeśli textStyle ma wartość null, ta metoda nie robi nic.

// 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

Nazwa	Typ	Opis
textStyle	TextStyle	Ustawiany styl tekstu.

Powrót

RichTextValueBuilder – to narzędzie do tworzenia łańcuchów.