Class RichTextValueBuilder

RichTextValueBuilder

Trình tạo cho các giá trị Văn bản đa dạng thức.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
build()RichTextValueTạo giá trị Văn bản đa dạng thức từ trình tạo này.
setLinkUrl(startOffset, endOffset, linkUrl)RichTextValueBuilderĐặt URL đường liên kết cho chuỗi con đã cho của giá trị này hoặc xoá URL đó nếu linkUrlnull.
setLinkUrl(linkUrl)RichTextValueBuilderĐặt URL đường liên kết cho toàn bộ giá trị hoặc xoá URL đó nếu linkUrlnull.
setText(text)RichTextValueBuilderĐặt văn bản cho giá trị này và xoá mọi kiểu văn bản hiện có.
setTextStyle(startOffset, endOffset, textStyle)RichTextValueBuilderÁp dụng kiểu văn bản cho chuỗi con đã cho của giá trị này.
setTextStyle(textStyle)RichTextValueBuilderÁp dụng kiểu văn bản cho toàn bộ giá trị.

Tài liệu chi tiết

build()

Tạo giá trị Văn bản đa dạng thức từ trình tạo này.

Cầu thủ trả bóng

RichTextValue – Giá trị Văn bản đa dạng thức được tạo từ trình tạo này.


setLinkUrl(startOffset, endOffset, linkUrl)

Đặt URL đường liên kết cho chuỗi con đã cho của giá trị này hoặc xoá URL đó nếu linkUrlnull.

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

Tham số

TênLoạiMô tả
startOffsetIntegerĐộ lệch bắt đầu của chuỗi con, bao gồm cả độ lệch.
endOffsetIntegerĐộ lệch cuối của chuỗi con, không bao gồm giá trị đầu và giá trị cuối.
linkUrlStringURL của đường liên kết đang được đặt.

Cầu thủ trả bóng

RichTextValueBuilder – Trình tạo này, để tạo chuỗi.


setLinkUrl(linkUrl)

Đặt URL đường liên kết cho toàn bộ giá trị hoặc xoá URL đó nếu linkUrlnull.

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

Tham số

TênLoạiMô tả
linkUrlStringURL của đường liên kết đang được đặt.

Cầu thủ trả bóng

RichTextValueBuilder – Trình tạo này, để tạo chuỗi.


setText(text)

Đặt văn bản cho giá trị này và xoá mọi kiểu văn bản hiện có. Khi tạo một giá trị Văn bản đa dạng thức mới, bạn phải gọi giá trị này trước setTextStyle(startOffset, endOffset, textStyle).

Tham số

TênLoạiMô tả
textStringVăn bản cho giá trị này.

Cầu thủ trả bóng

RichTextValueBuilder – Trình tạo này, để tạo chuỗi.


setTextStyle(startOffset, endOffset, textStyle)

Áp dụng kiểu văn bản cho chuỗi con đã cho của giá trị này. Độ dời dựa trên 0 và tương ứng với giá trị văn bản của ô. Không làm gì nếu textStylenull.

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

Tham số

TênLoạiMô tả
startOffsetIntegerĐộ lệch bắt đầu của chuỗi con, bao gồm cả độ lệch.
endOffsetIntegerĐộ lệch cuối của chuỗi con, không bao gồm giá trị đầu và giá trị cuối.
textStyleTextStyleKiểu văn bản đang được đặt.

Cầu thủ trả bóng

RichTextValueBuilder – Trình tạo này, để tạo chuỗi.


setTextStyle(textStyle)

Áp dụng kiểu văn bản cho toàn bộ giá trị. Các kiểu văn bản đã đặt trước đó chỉ bị ảnh hưởng nếu các kiểu đó bị ghi đè trực tiếp bằng các giá trị trong textStyle. Không làm gì nếu textStylenull.

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

Tham số

TênLoạiMô tả
textStyleTextStyleKiểu văn bản đang được đặt.

Cầu thủ trả bóng

RichTextValueBuilder – Trình tạo này, để tạo chuỗi.