Class RichTextValueBuilder

RichTextValueBuilder

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