Class RichTextValue
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
RichTextValue
Ein stilisierter Textstring, der Zellentext darstellt. Unterstränge des Texts können unterschiedliche Textstile haben.
Ein Block ist der längste durchgängige Teilstring mit demselben Textstil. Der Satz „Dieses Kind trägt Äpfel“ hat beispielsweise vier Läufe: ['This ', 'child ',
'is carrying ', 'apples'].
Detaillierte Dokumentation
copy()
Gibt einen Builder für einen Rich-Text-Wert zurück, der mit den Werten dieses Rich-Text-Werts initialisiert wird.
Rückflug
RichTextValueBuilder: Ein Tool zum Erstellen eines Rich-Text-Werts.
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: Die Link-URL für diesen Wert oder null, wenn kein Link vorhanden ist oder mehrere verschiedene Links vorhanden sind.
getLinkUrl(startOffset, endOffset)
Gibt die Link-URL für den Text von startOffset bis endOffset zurück. Die Offsets beginnen bei 0 und beziehen sich auf den Text der Zelle. Der Start-Offset ist inklusive, der End-Offset exklusiv.
Parameter
| Name | Typ | Beschreibung |
startOffset | Integer | Der Startversatz. |
endOffset | Integer | Endversatz. |
Rückflug
String: Die Link-URL für diesen Wert oder null, wenn es keinen Link gibt oder sich mehrere verschiedene Links im angegebenen Bereich befinden.
getRuns()
Gibt den Rich-Text-String als Array von Abläufen zurück, wobei jeder Lauf der längste mögliche Teilstring mit einem einheitlichen Textstil ist.
Rückflug
RichTextValue[] – ein Array von Ausführungen.
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()
Gibt den Textstil dieses Werts zurück.
Rückflug
TextStyle: Der Textstil dieses Werts.
getTextStyle(startOffset, endOffset)
Gibt den Textstil des Texts von startOffset in endOffset zurück. Die Offsets beginnen bei 0 und beziehen sich auf den Text der Zelle. Der Start-Offset ist inklusive, der End-Offset exklusiv.
Parameter
| Name | Typ | Beschreibung |
startOffset | Integer | Der Startversatz. |
endOffset | Integer | Endversatz. |
Rückflug
TextStyle: Der Textstil des angegebenen Teilstrings dieses Werts.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eRichTextValue\u003c/code\u003e objects represent stylized text within a spreadsheet cell, allowing substrings to have varied styles.\u003c/p\u003e\n"],["\u003cp\u003eText is broken into "runs," which are the longest continuous substrings sharing the same style.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eRichTextValue\u003c/code\u003e class provides methods to access and manipulate text, styles, and links within these runs.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can retrieve individual runs, get/set text styles, and extract link URLs using dedicated methods.\u003c/p\u003e\n"],["\u003cp\u003eMethods like \u003ccode\u003ecopy()\u003c/code\u003e, \u003ccode\u003egetText()\u003c/code\u003e, \u003ccode\u003egetRuns()\u003c/code\u003e, and \u003ccode\u003egetTextStyle()\u003c/code\u003e offer manipulation of \u003ccode\u003eRichTextValues\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Class RichTextValue\n\nRichTextValue\n\nA stylized text string used to represent cell text. Substrings of the text can have different\ntext styles.\n\nA *run* is the longest unbroken substring having the same text style. For example, the\nsentence, \"This **child** *is carrying* apples\" has 4 runs: `['This ', 'child ',\n'is carrying ', 'apples']`. \n\n### Methods\n\n| Method | Return type | Brief description |\n|------------------------------------------------------------------------|------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| [copy()](#copy()) | [RichTextValueBuilder](/apps-script/reference/spreadsheet/rich-text-value-builder) | Returns a builder for a Rich Text value initialized with the values of this Rich Text value. |\n| [getEndIndex()](#getEndIndex()) | `Integer` | Gets the end index of this value in the cell. |\n| [getLinkUrl()](#getLinkUrl()) | `String` | Returns the link URL for this value. |\n| [getLinkUrl(startOffset, endOffset)](#getLinkUrl(Integer,Integer)) | `String` | Returns the link URL for the text from `start``Offset` to `end``Offset`. |\n| [getRuns()](#getRuns()) | [RichTextValue[]](#) | Returns the Rich Text string split into an array of runs, wherein each run is the longest possible substring having a consistent text style. |\n| [getStartIndex()](#getStartIndex()) | `Integer` | Gets the start index of this value in the cell. |\n| [getText()](#getText()) | `String` | Returns the text of this value. |\n| [getTextStyle()](#getTextStyle()) | [TextStyle](/apps-script/reference/spreadsheet/text-style) | Returns the text style of this value. |\n| [getTextStyle(startOffset, endOffset)](#getTextStyle(Integer,Integer)) | [TextStyle](/apps-script/reference/spreadsheet/text-style) | Returns the text style of the text from `start``Offset` to `end``Offset`. |\n\nDetailed documentation\n----------------------\n\n### `copy()`\n\nReturns a builder for a Rich Text value initialized with the values of this Rich Text value.\n\n#### Return\n\n\n[RichTextValueBuilder](/apps-script/reference/spreadsheet/rich-text-value-builder) --- A builder for a Rich Text value.\n\n*** ** * ** ***\n\n### `get``End``Index()`\n\nGets the end index of this value in the cell.\n\n#### Return\n\n\n`Integer` --- The end index of this value in the cell.\n\n*** ** * ** ***\n\n### `get``Link``Url()`\n\nReturns the link URL for this value.\n\n#### Return\n\n\n`String` --- The link URL for this value, or `null` if there is no link or if there are\nmultiple different links.\n\n*** ** * ** ***\n\n### `get``Link``Url(startOffset, endOffset)`\n\nReturns the link URL for the text from `start``Offset` to `end``Offset`. Offsets are 0\nbased and relative to the cell's text, with the start offset being inclusive and the end offset\nbeing exclusive.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------------|-----------|-------------------|\n| `start``Offset` | `Integer` | The start offset. |\n| `end``Offset` | `Integer` | The end offset. |\n\n#### Return\n\n\n`String` --- The link URL for this value, or `null` if there is no link or if multiple\ndifferent links are in the given range.\n\n*** ** * ** ***\n\n### `get``Runs()`\n\nReturns the Rich Text string split into an array of runs, wherein each run is the longest\npossible substring having a consistent text style.\n\n#### Return\n\n\n[RichTextValue[]](#) --- An array of runs.\n\n*** ** * ** ***\n\n### `get``Start``Index()`\n\nGets the start index of this value in the cell.\n\n#### Return\n\n\n`Integer` --- The start index of this value in the cell.\n\n*** ** * ** ***\n\n### `get``Text()`\n\nReturns the text of this value.\n\n#### Return\n\n\n`String` --- The text of this value.\n\n*** ** * ** ***\n\n### `get``Text``Style()`\n\nReturns the text style of this value.\n\n#### Return\n\n\n[TextStyle](/apps-script/reference/spreadsheet/text-style) --- The text style of this value.\n\n*** ** * ** ***\n\n### `get``Text``Style(startOffset, endOffset)`\n\nReturns the text style of the text from `start``Offset` to `end``Offset`. Offsets are 0\nbased and relative to the cell's text, with the start offset being inclusive and the end offset\nbeing exclusive.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------------|-----------|-------------------|\n| `start``Offset` | `Integer` | The start offset. |\n| `end``Offset` | `Integer` | The end offset. |\n\n#### Return\n\n\n[TextStyle](/apps-script/reference/spreadsheet/text-style) --- The text style of the given substring of this value."]]
