Class RichTextValueBuilder

سازنده ارزش متن غنی

سازنده مقادیر 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 - این سازنده، برای زنجیره زدن.