Ein formatierter Textstring, der zum Darstellen von Zelltext verwendet wird. Teilstrings des Texts können unterschiedliche Textstile haben.
Ein Run ist der längste ununterbrochene Teilstring mit demselben Textstil. Der Satz „Das Kind trägt Äpfel“ besteht beispielsweise aus vier Runs: ['This ', 'child ',
'is carrying ', 'apples'].
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
copy() | Rich | Gibt einen Builder für einen Rich-Text-Wert zurück, der mit den Werten dieses Rich-Text-Werts initialisiert wurde. |
get | Integer | Ruft den Endindex dieses Werts in der Zelle ab. |
get | String|null | Gibt die Link-URL für diesen Wert zurück. |
get | String|null | Gibt die Link-URL für den Text von start bis end zurück. |
get | Rich | Gibt den Rich-Text-String in ein Array von Runs aufgeteilt zurück, wobei jeder Run der längstmögliche Teilstring mit einem einheitlichen Textstil ist. |
get | Integer | Ruft den Startindex dieses Werts in der Zelle ab. |
get | String | Gibt den Text dieses Werts zurück. |
get | Text | Gibt den Textstil dieses Werts zurück. |
get | Text | Gibt den Textstil des Texts von start bis end 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 wurde.
Rückflug
RichTextValueBuilder : Ein Builder für einen Rich-Text-Wert.
getEndIndex()
Ruft den Endindex dieses Werts in der Zelle ab.
Rückflug
Integer : Der Endindex dieses Werts in der Zelle.
getLinkUrl()
Gibt die Link-URL für diesen Wert zurück.
Rückflug
String|null : Die Link-URL für diesen Wert oder null, wenn kein Link vorhanden ist oder wenn
mehrere unterschiedliche Links vorhanden sind.
getLinkUrl(startOffset, endOffset)
Gibt die Link-URL für den Text von startOffset bis endOffset zurück. Offsets sind nullbasiert und relativ zum Text der Zelle. Der Start-Offset ist inklusive und der End-Offset ist exklusive.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
start | Integer | Der Start-Offset. |
end | Integer | Der End-Offset. |
Rückflug
String|null : Die Link-URL für diesen Wert oder null, wenn kein Link vorhanden ist oder wenn im angegebenen Bereich mehrere
unterschiedliche Links vorhanden sind.
getRuns()
Gibt den Rich-Text-String in ein Array von Runs aufgeteilt zurück, wobei jeder Run der längstmögliche Teilstring mit einem einheitlichen Textstil ist.
Rückflug
RichTextValue[] : Ein Array von Runs.
getStartIndex()
Ruft den Startindex dieses Werts in der Zelle ab.
Rückflug
Integer : Der Startindex dieses Werts in der Zelle.
getText()
Gibt den Text dieses Werts zurück.
Rückflug
String : Der Text dieses Werts.
getTextStyle()
getTextStyle(startOffset, endOffset)
Gibt den Textstil des Texts von startOffset bis endOffset zurück. Offsets sind nullbasiert und relativ zum Text der Zelle. Der Start-Offset ist inklusive und der End-Offset ist exklusive.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
start | Integer | Der Start-Offset. |
end | Integer | Der End-Offset. |
Rückflug
TextStyle : Der Textstil des angegebenen Teilstrings dieses Werts.