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

พารามิเตอร์

ชื่อTypeคำอธิบาย
startOffsetIntegerออฟเซ็ตเริ่มต้นสำหรับสตริงย่อย
endOffsetIntegerออฟเซ็ตสิ้นสุดสำหรับสตริงย่อย เฉพาะตัว
linkUrlStringURL ของลิงก์ที่กำลังตั้งค่า

รีเทิร์น

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คำอธิบาย
linkUrlStringURL ของลิงก์ที่กำลังตั้งค่า

รีเทิร์น

RichTextValueBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน


setText(text)

ตั้งค่าข้อความสำหรับค่านี้และล้างรูปแบบข้อความที่มีอยู่ เมื่อสร้างค่า Rich 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 — เครื่องมือสร้างนี้สำหรับการทำเชน