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