Class RichTextValue
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ارزش متن غنی یک رشته متن تلطیف شده که برای نمایش متن سلول استفاده می شود. زیر رشته های متن می توانند سبک های متن متفاوتی داشته باشند.
اجرا طولانی ترین زیررشته ناگسستنی است که همان سبک متن را دارد. به عنوان مثال، جمله "این کودک سیب را حمل می کند " دارای 4 اجرا است: ['This ', 'child ', 'is carrying ', 'apples'] .
مستندات دقیق
copy()
سازنده‌ای را برای یک مقدار Rich Text برمی‌گرداند که با مقادیر این مقدار Rich Text مقداردهی اولیه شده است.
بازگشت
Rich Text Value Builder - سازنده ارزش متن غنی.
get End Index()
نمایه پایانی این مقدار را در سلول دریافت می کند.
بازگشت
Integer - نمایه پایانی این مقدار در سلول.
get Link Url()
URL پیوند را برای این مقدار برمی گرداند.
بازگشت
String - URL پیوند برای این مقدار، یا اگر پیوندی وجود نداشته باشد یا چندین پیوند مختلف وجود دارد، null .
get Link Url(startOffset, endOffset)
URL پیوند متن را از start Offset تا end Offset برمی گرداند. آفست ها بر اساس 0 و نسبت به متن سلول هستند، با افست شروع شامل و آفست پایان انحصاری است.
پارامترها
| نام | تایپ کنید | توضیحات |
|---|
start Offset | Integer | شروع افست. |
end Offset | Integer | پایان افست. |
بازگشت
String - URL پیوند برای این مقدار، یا اگر پیوندی وجود نداشته باشد یا اگر چندین پیوند مختلف در محدوده داده شده باشد، null .
get Runs()
رشته Rich Text را که به آرایه‌ای از اجراها تقسیم شده است، برمی‌گرداند، که در آن هر اجرا طولانی‌ترین زیررشته ممکن است که دارای یک سبک متن ثابت است.
بازگشت
Rich Text Value[] - آرایه ای از اجراها.
get Start Index()
شاخص شروع این مقدار را در سلول دریافت می کند.
بازگشت
Integer - شاخص شروع این مقدار در سلول.
get Text()
متن این مقدار را برمی گرداند.
بازگشت
String - متن این مقدار.
get Text Style()
سبک متن این مقدار را برمی‌گرداند.
بازگشت
Text Style - سبک متن این مقدار.
get Text Style(startOffset, endOffset)
سبک متن متن را از start Offset به end Offset برمی‌گرداند. آفست ها بر اساس 0 و نسبت به متن سلول هستند، با افست شروع شامل و آفست پایان انحصاری است.
پارامترها
| نام | تایپ کنید | توضیحات |
|---|
start Offset | Integer | شروع افست. |
end Offset | Integer | پایان افست. |
بازگشت
Text Style - سبک متن زیر رشته داده شده از این مقدار.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
