Ein Generator 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 den Wert null hat. |
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 ein Textstil auf den gesamten Wert an. |
Detaillierte Dokumentation
build()
Erstellt einen Rich-Text-Wert aus diesem Builder.
Return
RichTextValue
: Ein mit diesem Builder erstellter Rich-Text-Wert.
setLinkUrl(startOffset, endOffset, linkUrl)
Legt die Link-URL für den angegebenen Teilstring dieses Werts fest oder löscht sie, wenn linkUrl
den Wert null
hat.
// 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 den Teilstring (einschließlich). |
endOffset | Integer | Der Endversatz für den Teilstring (ausschließlich). |
linkUrl | String | Die festgelegte Link-URL. |
Return
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 festgelegte Link-URL. |
Return
RichTextValueBuilder
: Dieser Builder für Verkettungen.
setText(text)
Legt den Text für diesen Wert fest und löscht alle vorhandenen Textstile. Wenn Sie einen neuen Rich Text-Wert erstellen, sollte dieser vor setTextStyle(startOffset, endOffset, textStyle)
aufgerufen werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | Der Text für diesen Wert. |
Return
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 zum 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 den Teilstring (einschließlich). |
endOffset | Integer | Der Endversatz für den Teilstring (ausschließlich). |
textStyle | TextStyle | Der Textstil, der festgelegt wird. |
Return
RichTextValueBuilder
: Dieser Builder für Verkettungen.
setTextStyle(textStyle)
Wendet ein Textstil auf den gesamten Wert an. Zuvor festgelegte Textstile sind nur betroffen, wenn sie direkt mit Werten in textStyle
überschrieben werden. Tut nichts, wenn textStyle
null
ist.
// 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. |
Return
RichTextValueBuilder
: Dieser Builder für Verkettungen.