Class RichTextValueBuilder

RichTextValueBuilder

Un generatore per i valori RTF.

Metodi

Metodo	Tipo restituito	Breve descrizione
build()	RichTextValue	Crea un valore RTF da questo generatore.
setLinkUrl(startOffset, endOffset, linkUrl)	RichTextValueBuilder	Imposta l'URL del link per la sottostringa specificata di questo valore o lo cancella se linkUrl è null.
setLinkUrl(linkUrl)	RichTextValueBuilder	Imposta l'URL del link per l'intero valore o lo cancella se linkUrl è null.
setText(text)	RichTextValueBuilder	Imposta il testo per questo valore e cancella qualsiasi stile di testo esistente.
setTextStyle(startOffset, endOffset, textStyle)	RichTextValueBuilder	Applica uno stile di testo alla sottostringa specificata di questo valore.
setTextStyle(textStyle)	RichTextValueBuilder	Applica uno stile di testo all'intero valore.

Documentazione dettagliata

build()

Crea un valore RTF da questo generatore.

Indietro

RichTextValue : un valore RTF creato da questo generatore.

---

setLinkUrl(startOffset, endOffset, linkUrl)

Imposta l'URL del link per la sottostringa specificata di questo valore o lo cancella se 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();

Parametri

Nome	Tipo	Descrizione
startOffset	Integer	L'offset iniziale per la sottostringa, inclusivo.
endOffset	Integer	L'offset finale per la sottostringa, esclusivo.
linkUrl	String	L'URL del link da impostare.

Indietro

RichTextValueBuilder : questo generatore, per il concatenamento.

---

setLinkUrl(linkUrl)

Imposta l'URL del link per l'intero valore o lo cancella se 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();

Parametri

Nome	Tipo	Descrizione
linkUrl	String	L'URL del link da impostare.

Indietro

RichTextValueBuilder : questo generatore, per il concatenamento.

---

setText(text)

Imposta il testo per questo valore e cancella qualsiasi stile di testo esistente. Quando crei un nuovo valore RTF, devi chiamare questo metodo prima di setTextStyle(startOffset, endOffset, textStyle).

Parametri

Nome	Tipo	Descrizione
text	String	Il testo per questo valore.

Indietro

RichTextValueBuilder : questo generatore, per il concatenamento.

---

setTextStyle(startOffset, endOffset, textStyle)

Applica uno stile di testo alla sottostringa specificata di questo valore. Gli offset sono basati su 0 e sono relativi al valore di testo della cella. Non esegue alcuna operazione se 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();

Parametri

Nome	Tipo	Descrizione
startOffset	Integer	L'offset iniziale per la sottostringa, inclusivo.
endOffset	Integer	L'offset finale per la sottostringa, esclusivo.
textStyle	TextStyle	Lo stile di testo da impostare.

Indietro

RichTextValueBuilder : questo generatore, per il concatenamento.

---

setTextStyle(textStyle)

Applica uno stile di testo all'intero valore. Gli stili di testo impostati in precedenza vengono interessati solo se vengono sovrascritti direttamente dai valori all'interno di textStyle. Non esegue alcuna operazione se 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();

Parametri

Nome	Tipo	Descrizione
textStyle	TextStyle	Lo stile di testo da impostare.

Indietro

RichTextValueBuilder : questo generatore, per il concatenamento.