Class RichTextValueBuilder

RichTextValueBuilder

أداة إنشاء لقيم النص المنسَّق

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
build()RichTextValueتنشئ قيمة نص منسق من أداة الإنشاء هذه.
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()

تنشئ قيمة نص منسق من أداة الإنشاء هذه.

استرجاع الكرة

RichTextValue - قيمة نص منسق تم إنشاؤها من أداة الإنشاء هذه.


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();

المَعلمات

الاسمTypeالوصف
startOffsetIntegerإزاحة البداية للسلسلة الفرعية شاملة.
endOffsetIntegerإزاحة النهاية للسلسلة الفرعية حصرية.
linkUrlStringعنوان 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();

المَعلمات

الاسمTypeالوصف
linkUrlStringعنوان URL للرابط الذي يتم إعداده.

استرجاع الكرة

RichTextValueBuilder: أداة الإنشاء هذه مخصّصة للسلاسل


setText(text)

لضبط النص لهذه القيمة ومحو أي نمط نص حالي. عند إنشاء قيمة نص منسق جديد، يجب استدعاء هذه القيم قبل setTextStyle(startOffset, endOffset, textStyle).

المَعلمات

الاسمTypeالوصف
textStringنص هذه القيمة.

استرجاع الكرة

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();

المَعلمات

الاسمTypeالوصف
startOffsetIntegerإزاحة البداية للسلسلة الفرعية شاملة.
endOffsetIntegerإزاحة النهاية للسلسلة الفرعية حصرية.
textStyleTextStyleنمط النص الذي يتم تعيينه.

استرجاع الكرة

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();

المَعلمات

الاسمTypeالوصف
textStyleTextStyleنمط النص الذي يتم تعيينه.

استرجاع الكرة

RichTextValueBuilder: أداة الإنشاء هذه مخصّصة للسلاسل