Ein Builder für Rich-Text-Werte.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
build() | RichTextValue | Erstellt einen Rich-Text-Wert aus diesem Builder. |
setLinkUrl(startOffset, endOffset, linkUrl) | RichTextValueBuilder | Legt die Link-URL für den angegebenen Teilstring dieses Werts fest oder löscht sie, wenn linkUrl Folgendes ist:
null . |
setLinkUrl(linkUrl) | RichTextValueBuilder | Legt die Link-URL für den gesamten Wert fest oder löscht sie, wenn linkUrl den Wert null hat. |
setText(text) | RichTextValueBuilder | Legt den Text für diesen Wert fest und löscht alle vorhandenen Textstile. |
setTextStyle(startOffset, endOffset, textStyle) | RichTextValueBuilder | Wendet einen Textstil auf die angegebene Teilzeichenfolge dieses Werts an. |
setTextStyle(textStyle) | RichTextValueBuilder | Wendet einen Textstil auf den gesamten Wert an. |
Detaillierte Dokumentation
build()
Erstellt einen Rich-Text-Wert aus diesem Builder.
Rückflug
RichTextValue
: Ein von diesem Builder erstellter RTF-Wert.
setLinkUrl(startOffset, endOffset, linkUrl)
Legt die Link-URL für den angegebenen Teilstring dieses Werts fest oder löscht sie, wenn linkUrl
Folgendes ist:
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
Name | Typ | Beschreibung |
---|---|---|
startOffset | Integer | Der Startversatz für die Teilzeichenfolge (einschließlich). |
endOffset | Integer | Der Endversatz für die Teilzeichenfolge, ausschließlich. |
linkUrl | String | Die Link-URL, die festgelegt wird. |
Rückflug
RichTextValueBuilder
: Dieser Builder für Verkettungen.
setLinkUrl(linkUrl)
Legt die Link-URL für den gesamten Wert fest oder löscht sie, wenn linkUrl
den Wert null
hat.
// 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
Name | Typ | Beschreibung |
---|---|---|
linkUrl | String | Die Link-URL, die festgelegt wird. |
Rückflug
RichTextValueBuilder
: Dieser Builder für Verkettungen.
setText(text)
Legt den Text für diesen Wert fest und löscht alle vorhandenen Textstile. Beim Erstellen eines neuen Rich-Text-
muss vor setTextStyle(startOffset, endOffset, textStyle)
aufgerufen werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | Der Text für diesen Wert. |
Rückflug
RichTextValueBuilder
: Dieser Builder für Verkettungen.
setTextStyle(startOffset, endOffset, textStyle)
Wendet einen Textstil auf die angegebene Teilzeichenfolge dieses Werts an. Offsets sind 0-basiert und relativ
mit dem Textwert der Zelle. Tut nichts, wenn textStyle
null
ist.
// 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
Name | Typ | Beschreibung |
---|---|---|
startOffset | Integer | Der Startversatz für die Teilzeichenfolge (einschließlich). |
endOffset | Integer | Der Endversatz für die Teilzeichenfolge, ausschließlich. |
textStyle | TextStyle | Der Textstil, der festgelegt wird. |
Rückflug
RichTextValueBuilder
: Dieser Builder für Verkettungen.
setTextStyle(textStyle)
Wendet einen Textstil auf den gesamten Wert an. Zuvor festgelegte Textstile sind nur betroffen, wenn sie
werden direkt von Werten in textStyle
überschrieben. Tut nichts, wenn textStyle
ist 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
Name | Typ | Beschreibung |
---|---|---|
textStyle | TextStyle | Der Textstil, der festgelegt wird. |
Rückflug
RichTextValueBuilder
: Dieser Builder für Verkettungen.