หน้านี้ได้รับการแปลโดย Cloud Translation API

Class 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 — ค่าข้อความที่มีรูปแบบที่สร้างจากเครื่องมือสร้างนี้

`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)`

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

`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 — ตัวสร้างนี้สําหรับการต่อเชื่อม