เครื่องมือสร้างสำหรับค่า 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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่