سازنده مقادیر Rich Text.
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
build() | RichTextValue | یک مقدار Rich Text از این سازنده ایجاد می کند. |
setLinkUrl(startOffset, endOffset, linkUrl) | RichTextValueBuilder | URL پیوند را برای زیر رشته داده شده از این مقدار تنظیم می کند، یا اگر linkUrl null باشد، آن را پاک می کند. |
setLinkUrl(linkUrl) | RichTextValueBuilder | URL پیوند را برای کل مقدار تنظیم می کند، یا اگر linkUrl null باشد، آن را پاک می کند. |
setText(text) | RichTextValueBuilder | متن را برای این مقدار تنظیم می کند و هر سبک متن موجود را پاک می کند. |
setTextStyle(startOffset, endOffset, textStyle) | RichTextValueBuilder | یک سبک متن را به زیر رشته داده شده از این مقدار اعمال می کند. |
setTextStyle(textStyle) | RichTextValueBuilder | یک سبک متن را برای کل مقدار اعمال می کند. |
مستندات دقیق
build()
یک مقدار Rich Text از این سازنده ایجاد می کند.
بازگشت
RichTextValue
- یک مقدار Rich Text ایجاد شده از این سازنده.
setLinkUrl(startOffset, endOffset, linkUrl)
URL پیوند را برای زیر رشته داده شده از این مقدار تنظیم می کند، یا اگر linkUrl
null
باشد، آن را پاک می کند.
// Creates a Rich Text value for the text "foo no baz" with "foo" pointing to // "https://bar.foo" and "baz" to "https://abc.xyz". // "foo" is underlined with the default link color, whereas "baz" has its text style // overridden by a call to `setTextStyle`, and is therefore black and bold with no underlining. const boldStyle = SpreadsheetApp.newTextStyle() .setUnderline(false) .setBold(true) .setForegroundColor("#000000") .build(); const value = SpreadsheetApp.newRichTextValue() .setText("foo no baz") .setLinkUrl(0, 3, "https://bar.foo") .setLinkUrl(7, 10, "https://abc.xyz") .setTextStyle(7, 10, boldStyle) .build();
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
startOffset | Integer | آفست شروع برای رشته فرعی، شامل. |
endOffset | Integer | افست پایانی برای رشته فرعی، انحصاری. |
linkUrl | String | URL پیوند در حال تنظیم است. |
بازگشت
RichTextValueBuilder
- این سازنده، برای زنجیره زدن.
setLinkUrl(linkUrl)
URL پیوند را برای کل مقدار تنظیم می کند، یا اگر linkUrl
null
باشد، آن را پاک می کند.
// Creates a Rich Text value for the text "Foo" which points to "https://bar.foo". const value = SpreadsheetApp.newRichTextValue() .setText("Foo") .setLinkUrl("https://bar.foo") .build();
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
linkUrl | String | URL پیوند در حال تنظیم است. |
بازگشت
RichTextValueBuilder
- این سازنده، برای زنجیره زدن.
setText(text)
متن را برای این مقدار تنظیم می کند و هر سبک متن موجود را پاک می کند. هنگام ایجاد یک مقدار Rich Text جدید، باید قبل از setTextStyle(startOffset, endOffset, textStyle)
فراخوانی شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
text | String | متن برای این مقدار. |
بازگشت
RichTextValueBuilder
- این سازنده، برای زنجیره زدن.
setTextStyle(startOffset, endOffset, textStyle)
یک سبک متن را به زیر رشته داده شده از این مقدار اعمال می کند. آفست ها بر اساس 0 هستند و نسبت به مقدار متن سلول هستند. اگر textStyle
null
باشد کاری انجام نمی دهد.
// Creates a Rich Text value for the text "HelloWorld", with "Hello" bolded, and "World" // italicized. var bold = SpreadsheetApp.newTextStyle().setBold(true).build(); var italic = SpreadsheetApp.newTextStyle().setItalic(true).build(); var value = SpreadsheetApp.newRichTextValue() .setText("HelloWorld") .setTextStyle(0, 5, bold) .setTextStyle(5, 10, italic) .build();
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
startOffset | Integer | آفست شروع برای رشته فرعی، شامل. |
endOffset | Integer | افست پایانی برای رشته فرعی، انحصاری. |
textStyle | TextStyle | سبک متن در حال تنظیم است. |
بازگشت
RichTextValueBuilder
- این سازنده، برای زنجیره زدن.
setTextStyle(textStyle)
یک سبک متن را برای کل مقدار اعمال می کند. سبکهای متنی که قبلاً تنظیم شدهاند تنها در صورتی تحت تأثیر قرار میگیرند که مستقیماً توسط مقادیر درون textStyle
بازنویسی شوند. اگر textStyle
null
باشد کاری انجام نمی دهد.
// Creates a Rich Text value for the text "HelloWorld" with "Hello" bolded and italicized, // and "World" only italicized. var bold = SpreadsheetApp.newTextStyle().setBold(true).build(); var italic = SpreadsheetApp.newTextStyle().setItalic(true).build(); var value = SpreadsheetApp.newRichTextValue() .setText("HelloWorld") .setTextStyle(0, 5, bold) .setTextStyle(italic) .build();
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
textStyle | TextStyle | سبک متن در حال تنظیم است. |
بازگشت
RichTextValueBuilder
- این سازنده، برای زنجیره زدن.