Class RichTextValueBuilder

RichTextValueBuilder

בורר לערכים של טקסט עשיר.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
build()	RichTextValue	יצירת ערך של טקסט עשיר מה-builder הזה.
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()

יצירת ערך של טקסט עשיר מה-builder הזה.

חזרה

RichTextValue – ערך של טקסט עשיר שנוצר מה-builder הזה.

---

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 – ה-builder הזה, לשרשור.

---

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 – ה-builder הזה, לשרשור.

---

setText(text)

הפונקציה מגדירה את הטקסט לערך הזה ומוחקת כל סגנון טקסט קיים. כשיוצרים ערך חדש של טקסט עשיר, צריך לבצע את הקריאה הזו לפני setTextStyle(startOffset, endOffset, textStyle).

פרמטרים

שם	סוג	תיאור
text	String	הטקסט של הערך הזה.

חזרה

RichTextValueBuilder – ה-builder הזה, לשרשור.

---

setTextStyle(startOffset, endOffset, textStyle)

מחילה סגנון טקסט על מחרוזת המשנה של הערך הזה. ההיסטים מבוססים על 0 והם יחסיים לערך הטקסט של התא. לא מתבצעת שום פעולה אם הערך של textStyle הוא 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();

פרמטרים

שם	סוג	תיאור
startOffset	Integer	היסט ההתחלה של מחרוזת המשנה, כולל.
endOffset	Integer	היסט הסיום של מחרוזת המשנה, בלעדי.
textStyle	TextStyle	סגנון הטקסט שמוגדר.

חזרה

RichTextValueBuilder – ה-builder הזה, לשרשור.

---

setTextStyle(textStyle)

החלת סגנון טקסט על כל הערך. סגנונות טקסט שהוגדרו בעבר מושפעים רק אם הם מוחלפים ישירות על ידי ערכים ב-textStyle. לא מתבצעת שום פעולה אם הערך של textStyle הוא 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();

פרמטרים

שם	סוג	תיאור
textStyle	TextStyle	סגנון הטקסט שמוגדר.

חזרה

RichTextValueBuilder – ה-builder הזה, לשרשור.