سازنده مقادیر Rich Text.
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
build() | Rich Text Value | یک مقدار Rich Text از این سازنده ایجاد می کند. |
set Link Url(startOffset, endOffset, linkUrl) | Rich Text Value Builder | URL پیوند را برای زیررشته داده شده از این مقدار تنظیم می کند، یا اگر link Url null باشد، آن را پاک می کند. |
set Link Url(linkUrl) | Rich Text Value Builder | URL پیوند را برای کل مقدار تنظیم می کند، یا اگر link Url null باشد، آن را پاک می کند. |
set Text(text) | Rich Text Value Builder | متن را برای این مقدار تنظیم می کند و هر سبک متن موجود را پاک می کند. |
set Text Style(startOffset, endOffset, textStyle) | Rich Text Value Builder | یک سبک متن را به زیر رشته داده شده از این مقدار اعمال می کند. |
set Text Style(textStyle) | Rich Text Value Builder | یک سبک متن را برای کل مقدار اعمال می کند. |
مستندات دقیق
build()
یک مقدار Rich Text از این سازنده ایجاد می کند.
بازگشت
Rich Text Value
- یک مقدار Rich Text که از این سازنده ایجاد شده است.
set Link Url(startOffset, endOffset, linkUrl)
URL پیوند را برای زیررشته داده شده از این مقدار تنظیم می کند، یا اگر link Url
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();
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
start Offset | Integer | آفست شروع برای رشته فرعی، شامل. |
end Offset | Integer | افست پایانی برای رشته فرعی، انحصاری. |
link Url | String | URL پیوند در حال تنظیم است. |
بازگشت
Rich Text Value Builder
- این سازنده، برای زنجیره زدن.
set Link Url(linkUrl)
URL پیوند را برای کل مقدار تنظیم می کند، یا اگر link Url
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();
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
link Url | String | URL پیوند در حال تنظیم است. |
بازگشت
Rich Text Value Builder
- این سازنده، برای زنجیره زدن.
set Text(text)
متن را برای این مقدار تنظیم می کند و هر سبک متن موجود را پاک می کند. هنگام ایجاد یک مقدار Rich Text جدید، این باید قبل از set Text Style(startOffset, endOffset, textStyle)
فراخوانی شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
text | String | متن برای این مقدار. |
بازگشت
Rich Text Value Builder
- این سازنده، برای زنجیره زدن.
set Text Style(startOffset, endOffset, textStyle)
یک سبک متن را به زیر رشته داده شده از این مقدار اعمال می کند. آفست ها بر اساس 0 هستند و نسبت به مقدار متن سلول هستند. اگر text Style
null
باشد کاری انجام نمی دهد.
// Creates a Rich Text value for the text "HelloWorld", with "Hello" bolded, and // "World" italicized. const bold = SpreadsheetApp.newTextStyle().setBold(true).build(); const italic = SpreadsheetApp.newTextStyle().setItalic(true).build(); const value = SpreadsheetApp.newRichTextValue() .setText('HelloWorld') .setTextStyle(0, 5, bold) .setTextStyle(5, 10, italic) .build();
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
start Offset | Integer | آفست شروع برای رشته فرعی، شامل. |
end Offset | Integer | افست پایانی برای رشته فرعی، انحصاری. |
text Style | Text Style | سبک متن در حال تنظیم است. |
بازگشت
Rich Text Value Builder
- این سازنده، برای زنجیره زدن.
set Text Style(textStyle)
یک سبک متن را برای کل مقدار اعمال می کند. سبکهای متنی که قبلاً تنظیم شدهاند، تنها در صورتی تحت تأثیر قرار میگیرند که مستقیماً توسط مقادیر درون text Style
بازنویسی شوند. اگر text Style
null
باشد کاری انجام نمی دهد.
// Creates a Rich Text value for the text "HelloWorld" with "Hello" bolded and // italicized, and "World" only italicized. const bold = SpreadsheetApp.newTextStyle().setBold(true).build(); const italic = SpreadsheetApp.newTextStyle().setItalic(true).build(); const value = SpreadsheetApp.newRichTextValue() .setText('HelloWorld') .setTextStyle(0, 5, bold) .setTextStyle(italic) .build();
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
text Style | Text Style | سبک متن در حال تنظیم است. |
بازگشت
Rich Text Value Builder
- این سازنده، برای زنجیره زدن.