این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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