Kreator wartości w postaci tekstu sformatowanego.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | RichTextValue | Tworzy wartość tekstu sformatowanego za pomocą 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 go, jeśli linkUrl ma wartość null . |
setText(text) | RichTextValueBuilder | Ustawia tekst dla tej wartości i usuwa istniejący styl tekstu. |
setTextStyle(startOffset, endOffset, textStyle) | RichTextValueBuilder | Stosuje styl tekstu do danego podłańcucha tej wartości. |
setTextStyle(textStyle) | RichTextValueBuilder | Stosuje styl tekstu do całej wartości. |
Szczegółowa dokumentacja
build()
Tworzy wartość tekstu sformatowanego za pomocą tego kreatora.
Powrót
RichTextValue
– wartość tekstowa utworzona za pomocą 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 | Przesunięcie początku podłańcucha (włącznie). |
endOffset | Integer | Koniec przesunięcia podłańcucha (bez tych wartości). |
linkUrl | String | Ustawiony adres URL linku. |
Powrót
RichTextValueBuilder
– narzędzie do tworzenia łańcuchów.
setLinkUrl(linkUrl)
Ustawia adres URL linku dla całej wartości lub usuwa 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 | Ustawiony adres URL linku. |
Powrót
RichTextValueBuilder
– narzędzie do tworzenia łańcuchów.
setText(text)
Ustawia tekst dla tej wartości i usuwa istniejący styl tekstu. Podczas tworzenia nowego tekstu sformatowanego
powinna zostać wywołana przed setTextStyle(startOffset, endOffset, textStyle)
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst tej wartości. |
Powrót
RichTextValueBuilder
– narzędzie do tworzenia łańcuchów.
setTextStyle(startOffset, endOffset, textStyle)
Stosuje styl tekstu do danego podłańcucha tej wartości. Przesunięcia są oparte na 0 i są względne
do wartości tekstowej komórki. Nie działa, 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 | Przesunięcie początku podłańcucha (włącznie). |
endOffset | Integer | Koniec przesunięcia podłańcucha (bez tych wartości). |
textStyle | TextStyle | Ustawiony styl tekstu. |
Powrót
RichTextValueBuilder
– narzędzie do tworzenia łańcuchów.
setTextStyle(textStyle)
Stosuje styl tekstu do całej wartości. Wcześniej ustawione style tekstu mają wpływ tylko wtedy, gdy
są bezpośrednio zastąpione wartościami w obrębie textStyle
. Nie robi nic, jeśli textStyle
jest 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. |
Powrót
RichTextValueBuilder
– narzędzie do tworzenia łańcuchów.