Eine stilisierte Textzeichenfolge, die zur Darstellung von Zellentext verwendet wird. Teilstrings des Textes können unterschiedliche Textstile haben.
Ein run ist der längste Teilstring ohne Umbruch mit demselben Textstil. Der Satz „Dieses Kind tragt Äpfel“ hat beispielsweise vier Ausführungen: ['This ', 'child ',
'is carrying ', 'apples']
.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
copy() | RichTextValueBuilder | Gibt einen Builder für einen Rich-Text-Wert zurück, der mit den Werten dieses Rich-Text-Werts initialisiert wird. |
getEndIndex() | Integer | Ruft den Endindex dieses Werts in der Zelle ab. |
getLinkUrl() | String | Gibt die Link-URL für diesen Wert zurück |
getLinkUrl(startOffset, endOffset) | String | Gibt die Link-URL für den Text von startOffset bis endOffset zurück |
getRuns() | RichTextValue[] | Gibt den Rich-Text-String zurück, der in ein Array von Ausführungen aufgeteilt ist, wobei jeder Durchlauf der längste mögliche Teilstring mit einem einheitlichen Textstil ist. |
getStartIndex() | Integer | Ruft den Startindex dieses Werts in der Zelle ab. |
getText() | String | Gibt den Text dieses Werts zurück |
getTextStyle() | TextStyle | Gibt den Textstil dieses Werts zurück |
getTextStyle(startOffset, endOffset) | TextStyle | Gibt den Textstil des Textes von startOffset bis endOffset zurück. |
Detaillierte Dokumentation
copy()
Gibt einen Builder für einen Rich-Text-Wert zurück, der mit den Werten dieses Rich-Text-Werts initialisiert wird.
Return
RichTextValueBuilder
: Ein Generator für einen Rich-Text-Wert.
getEndIndex()
Ruft den Endindex dieses Werts in der Zelle ab.
Return
Integer
: Der Endindex dieses Werts in der Zelle.
getLinkUrl()
Gibt die Link-URL für diesen Wert zurück
Return
String
: Die Link-URL für diesen Wert oder null
, wenn kein Link vorhanden ist oder es mehrere verschiedene Links gibt.
getLinkUrl(startOffset, endOffset)
Gibt die Link-URL für den Text von startOffset
bis endOffset
zurück Offsets sind 0-basiert und relativ zum Text der Zelle, wobei der Start-Offset einschließend und der End-Offset ausgeschlossen ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
startOffset | Integer | Der Startversatz. |
endOffset | Integer | Der Endversatz. |
Return
String
: Die Link-URL für diesen Wert oder null
, wenn kein Link vorhanden ist oder wenn sich mehrere verschiedene Links im angegebenen Bereich befinden.
getRuns()
Gibt den Rich-Text-String zurück, der in ein Array von Ausführungen aufgeteilt ist, wobei jeder Durchlauf der längste mögliche Teilstring mit einem einheitlichen Textstil ist.
Return
RichTextValue[]
: Ein Array von Ausführungen.
getStartIndex()
Ruft den Startindex dieses Werts in der Zelle ab.
Return
Integer
: Der Startindex dieses Werts in der Zelle.
getText()
Gibt den Text dieses Werts zurück
Return
String
: Der Text dieses Werts.
getTextStyle()
getTextStyle(startOffset, endOffset)
Gibt den Textstil des Textes von startOffset
bis endOffset
zurück. Offsets sind 0-basiert und relativ zum Text der Zelle, wobei der Start-Offset einschließend und der End-Offset ausgeschlossen ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
startOffset | Integer | Der Startversatz. |
endOffset | Integer | Der Endversatz. |
Return
TextStyle
– Der Textstil des angegebenen Teilstrings dieses Werts.