Class RichTextValueBuilder

RichTextValueBuilder

Kreator wartości w postaci tekstu sformatowanego.

Metody

Metoda	Zwracany typ	Krótki opis
build()	RichTextValue	Tworzy wartość tekstu sformatowanego za pomocą tego kreatora.
setLinkUrl(startOffset, endOffset, linkUrl)	RichTextValueBuilder	Ustawia adres URL linku dla danego podłańcucha tej wartości lub usuwa go, jeśli linkUrl ma wartość null
setLinkUrl(linkUrl)	RichTextValueBuilder	Ustawia adres URL linku dla całej wartości lub usuwa go, jeśli linkUrl ma wartość null.
setText(text)	RichTextValueBuilder	Ustawia tekst dla tej wartości i usuwa istniejący styl tekstu.
setTextStyle(startOffset, endOffset, textStyle)	RichTextValueBuilder	Stosuje styl tekstu do danego podłańcucha tej wartości.
setTextStyle(textStyle)	RichTextValueBuilder	Stosuje styl tekstu do całej wartości.

Szczegółowa dokumentacja

build()

Tworzy wartość tekstu sformatowanego za pomocą tego kreatora.

Powrót

RichTextValue – wartość tekstowa utworzona za pomocą 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

Nazwa	Typ	Opis
startOffset	Integer	Przesunięcie początku podłańcucha (włącznie).
endOffset	Integer	Koniec przesunięcia podłańcucha (bez tych wartości).
linkUrl	String	Ustawiony adres URL linku.

Powrót

RichTextValueBuilder – narzędzie do tworzenia łańcuchów.

---

setLinkUrl(linkUrl)

Ustawia adres URL linku dla całej wartości lub usuwa go, 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

Nazwa	Typ	Opis
linkUrl	String	Ustawiony adres URL linku.

Powrót

RichTextValueBuilder – narzędzie do tworzenia łańcuchów.

---

setText(text)

Ustawia tekst dla tej wartości i usuwa istniejący styl tekstu. Podczas tworzenia nowego tekstu sformatowanego powinna zostać wywołana przed setTextStyle(startOffset, endOffset, textStyle).

Parametry

Nazwa	Typ	Opis
text	String	Tekst tej wartości.

Powrót

RichTextValueBuilder – narzędzie do tworzenia łańcuchów.

---

setTextStyle(startOffset, endOffset, textStyle)

Stosuje styl tekstu do danego podłańcucha tej wartości. Przesunięcia są oparte na 0 i są względne do wartości tekstowej komórki. Nie działa, 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

Nazwa	Typ	Opis
startOffset	Integer	Przesunięcie początku podłańcucha (włącznie).
endOffset	Integer	Koniec przesunięcia podłańcucha (bez tych wartości).
textStyle	TextStyle	Ustawiony styl tekstu.

Powrót

RichTextValueBuilder – narzędzie do tworzenia łańcuchów.

---

setTextStyle(textStyle)

Stosuje styl tekstu do całej wartości. Wcześniej ustawione style tekstu mają wpływ tylko wtedy, gdy są bezpośrednio zastąpione wartościami w obrębie textStyle. Nie robi nic, jeśli textStyle jest 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

Nazwa	Typ	Opis
textStyle	TextStyle	Ustawiony styl tekstu.

Powrót

RichTextValueBuilder – narzędzie do tworzenia łańcuchów.