Kreator wartości tekstu sformatowanego.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | RichTextValue | Tworzy wartość tekstu sformatowanego z tego kreatora. |
setLinkUrl(startOffset, endOffset, linkUrl) | RichTextValueBuilder | Ustawia adres URL linku dla danego podłańcucha tej wartości lub usuwa go, jeśli linkUrl ma wartość null . |
setLinkUrl(linkUrl) | RichTextValueBuilder | Ustawia adres URL linku dla całej wartości lub usuwa ją, jeśli linkUrl ma wartość null . |
setText(text) | RichTextValueBuilder | Ustawia tekst tej wartości i usuwa wszystkie istniejące style. |
setTextStyle(startOffset, endOffset, textStyle) | RichTextValueBuilder | Stosuje styl tekstu do danego podłańcucha tej wartości. |
setTextStyle(textStyle) | RichTextValueBuilder | Pozwala zastosować styl tekstu do całej wartości. |
Szczegółowa dokumentacja
build()
Tworzy wartość tekstu sformatowanego z tego kreatora.
Powroty
RichTextValue
– wartość tekstowa utworzona z poziomu tego kreatora.
setLinkUrl(startOffset, endOffset, linkUrl)
Ustawia adres URL linku dla danego podłańcucha tej wartości lub usuwa 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 | Opóźnienie rozpoczęcia podłańcucha (włącznie). |
endOffset | Integer | Przesunięcie końcowe dla podłańcucha (wyłącznie). |
linkUrl | String | Ustawiany adres URL linku. |
Powroty
RichTextValueBuilder
– kreator do tworzenia łańcuchów.
setLinkUrl(linkUrl)
Ustawia adres URL linku dla całej wartości lub usuwa ją, 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. |
Powroty
RichTextValueBuilder
– kreator do tworzenia łańcuchów.
setText(text)
Ustawia tekst tej wartości i usuwa wszystkie istniejące style. Podczas tworzenia nowej wartości w postaci tekstu sformatowanego należy ją wywołać przed setTextStyle(startOffset, endOffset, textStyle)
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst tej wartości. |
Powroty
RichTextValueBuilder
– kreator do tworzenia łańcuchów.
setTextStyle(startOffset, endOffset, textStyle)
Stosuje styl tekstu do danego podłańcucha tej wartości. Przesunięcia są zależne od wartości tekstowej komórki
i zależą od wartości 0. Nie dzieje się, jeśli textStyle
ma wartość 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();
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Opóźnienie rozpoczęcia podłańcucha (włącznie). |
endOffset | Integer | Przesunięcie końcowe dla podłańcucha (wyłącznie). |
textStyle | TextStyle | Ustawiony styl tekstu. |
Powroty
RichTextValueBuilder
– kreator do tworzenia łańcuchów.
setTextStyle(textStyle)
Pozwala zastosować styl tekstu do całej wartości. Wcześniej ustawione style tekstu mają wpływ tylko wtedy, gdy zostaną bezpośrednio zastąpione wartościami w zasadzie textStyle
. Nie ma żadnego działania, jeśli textStyle
ma wartość 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();
Parametry
Nazwa | Typ | Opis |
---|---|---|
textStyle | TextStyle | Ustawiony styl tekstu. |
Powroty
RichTextValueBuilder
– kreator do tworzenia łańcuchów.