Class RichTextValueBuilder

RichTextValueBuilder

Kreator wartości tekstu sformatowanego.

Metody

MetodaZwracany typKrótki opis
build()RichTextValueTworzy wartość tekstu sformatowanego z tego kreatora.
setLinkUrl(startOffset, endOffset, linkUrl)RichTextValueBuilderUstawia adres URL linku dla danego podłańcucha tej wartości lub usuwa go, jeśli linkUrl ma wartość null.
setLinkUrl(linkUrl)RichTextValueBuilderUstawia adres URL linku dla całej wartości lub usuwa ją, jeśli linkUrl ma wartość null.
setText(text)RichTextValueBuilderUstawia tekst tej wartości i usuwa wszystkie istniejące style.
setTextStyle(startOffset, endOffset, textStyle)RichTextValueBuilderStosuje styl tekstu do danego podłańcucha tej wartości.
setTextStyle(textStyle)RichTextValueBuilderPozwala zastosować styl tekstu do całej wartości.

Szczegółowa dokumentacja

build()

Tworzy wartość tekstu sformatowanego z tego kreatora.

Powroty

RichTextValue – wartość tekstowa utworzona z poziomu tego kreatora.


setLinkUrl(startOffset, endOffset, linkUrl)

Ustawia adres URL linku dla danego podłańcucha tej wartości lub usuwa go, jeśli linkUrl ma wartość 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();

Parametry

NazwaTypOpis
startOffsetIntegerOpóźnienie rozpoczęcia podłańcucha (włącznie).
endOffsetIntegerPrzesunięcie końcowe dla podłańcucha (wyłącznie).
linkUrlStringUstawiany adres URL linku.

Powroty

RichTextValueBuilder – kreator do tworzenia łańcuchów.


setLinkUrl(linkUrl)

Ustawia adres URL linku dla całej wartości lub usuwa ją, jeśli linkUrl ma wartość 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();

Parametry

NazwaTypOpis
linkUrlStringUstawiany adres URL linku.

Powroty

RichTextValueBuilder – kreator do tworzenia łańcuchów.


setText(text)

Ustawia tekst tej wartości i usuwa wszystkie istniejące style. Podczas tworzenia nowej wartości w postaci tekstu sformatowanego należy ją wywołać przed setTextStyle(startOffset, endOffset, textStyle).

Parametry

NazwaTypOpis
textStringTekst tej wartości.

Powroty

RichTextValueBuilder – kreator do tworzenia łańcuchów.


setTextStyle(startOffset, endOffset, textStyle)

Stosuje styl tekstu do danego podłańcucha tej wartości. Przesunięcia są zależne od wartości tekstowej komórki i zależą od wartości 0. Nie dzieje się, jeśli textStyle ma wartość 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();

Parametry

NazwaTypOpis
startOffsetIntegerOpóźnienie rozpoczęcia podłańcucha (włącznie).
endOffsetIntegerPrzesunięcie końcowe dla podłańcucha (wyłącznie).
textStyleTextStyleUstawiony styl tekstu.

Powroty

RichTextValueBuilder – kreator do tworzenia łańcuchów.


setTextStyle(textStyle)

Pozwala zastosować styl tekstu do całej wartości. Wcześniej ustawione style tekstu mają wpływ tylko wtedy, gdy zostaną bezpośrednio zastąpione wartościami w zasadzie textStyle. Nie ma żadnego działania, jeśli textStyle ma wartość 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();

Parametry

NazwaTypOpis
textStyleTextStyleUstawiony styl tekstu.

Powroty

RichTextValueBuilder – kreator do tworzenia łańcuchów.