أداة إنشاء لقيم النص المنسَّق
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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 | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
linkUrl | String | عنوان URL للرابط الذي يتم إعداده. |
استرجاع الكرة
RichTextValueBuilder
: أداة الإنشاء هذه مخصّصة للسلاسل
setText(text)
لضبط النص لهذه القيمة ومحو أي نمط نص حالي. عند إنشاء قيمة نص منسق جديد،
يجب استدعاء هذه القيم قبل setTextStyle(startOffset, endOffset, textStyle)
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textStyle | TextStyle | نمط النص الذي يتم تعيينه. |
استرجاع الكرة
RichTextValueBuilder
: أداة الإنشاء هذه مخصّصة للسلاسل