Class RichTextValue
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قيمةالنصالمنسّق
سلسلة نصية منمّقة تُستخدَم لتمثيل نص الخلية. يمكن أن تحتوي السلسلة الفرعية من النص على
أنماط نص مختلفة.
السلسلة هي أطول سلسلة فرعية غير متقطعة لها نمط النص نفسه. على سبيل المثال، تحتوي الجملة
"هذا الطفل يحمل تفاحات" على 4 عمليات تشغيل: ['This ', 'child ',
'is carrying ', 'apples'].
مستندات تفصيلية
copy()
تعرِض هذه الدالةّ منشئًا لقيمة نص منسق تمّت إعدادها باستخدام قيم قيمة النص المنسّق هذه.
الإرجاع
RichTextValueBuilder: أداة إنشاء لقيمة نص منسق
getEndIndex()
تحصل على فهرس نهاية هذه القيمة في الخلية.
الإرجاع
Integer: فهرس نهاية هذه القيمة في الخلية.
getLinkUrl()
لعرض عنوان URL للرابط لهذه القيمة.
الإرجاع
String: عنوان URL للرابط المؤدي إلى هذه القيمة، أو null في حال عدم توفّر رابط أو توفّر عدة روابط مختلفة.
getLinkUrl(startOffset, endOffset)
تعرِض هذه الدالة عنوان URL للرابط للنص من startOffset إلى endOffset. تستند الإزاحات إلى 0
وتكون نسبية لنص الخلية، مع أنّ إزاحة البداية شاملة وإزاحة النهاية
تكون حصرية.
المعلمات
| الاسم | النوع | الوصف |
startOffset | Integer | إزاحة البداية |
endOffset | Integer | بدء المقطع |
الإرجاع
String: عنوان URL للرابط لهذه القيمة، أو null إذا لم يكن هناك رابط أو إذا كان هناك عدة روابط مختلفة في النطاق المحدّد
getRuns()
عرض سلسلة نص غني مُقسَّمة إلى صفيف من المقاطع، حيث يكون كل مقطع هو أطول سلسلسة فرعية ممكنة لها نمط نص متسق
الإرجاع
RichTextValue[]: صفيف من عمليات التنفيذ
getStartIndex()
تحصل على فهرس بداية هذه القيمة في الخلية.
الإرجاع
Integer: فهرس بداية هذه القيمة في الخلية.
getText()
لعرض نص هذه القيمة.
الإرجاع
String: نص هذه القيمة.
getTextStyle()
لعرض نمط النص لهذه القيمة.
الإرجاع
TextStyle: نمط النص لهذه القيمة.
getTextStyle(startOffset, endOffset)
عرض نمط النص من startOffset إلى endOffset تستند الإزاحات إلى 0
وتكون نسبية لنص الخلية، مع أنّ إزاحة البداية شاملة وإزاحة النهاية
تكون حصرية.
المعلمات
| الاسم | النوع | الوصف |
startOffset | Integer | إزاحة البداية |
endOffset | Integer | بدء المقطع |
الإرجاع
TextStyle: نمط النص للسلسلة الفرعية المحدّدة من هذه القيمة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
