Class RichTextValueBuilder

RichTextValueBuilder

Un generatore per i valori RTF.

Metodi

MetodoTipo restituitoBreve descrizione
build()RichTextValueCrea un valore RTF da questo generatore.
setLinkUrl(startOffset, endOffset, linkUrl)RichTextValueBuilderImposta l'URL del link per la sottostringa specificata di questo valore o lo cancella se linkUrl è null.
setLinkUrl(linkUrl)RichTextValueBuilderImposta l'URL del link per l'intero valore o lo cancella se linkUrl è null.
setText(text)RichTextValueBuilderImposta il testo per questo valore e cancella qualsiasi stile di testo esistente.
setTextStyle(startOffset, endOffset, textStyle)RichTextValueBuilderApplica uno stile di testo alla sottostringa specificata di questo valore.
setTextStyle(textStyle)RichTextValueBuilderApplica uno stile di testo all'intero valore.

Documentazione dettagliata

build()

Crea un valore RTF da questo generatore.

Invio

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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale per la sottostringa, incluso.
endOffsetIntegerLo spostamento di fine per la sottostringa, escluso.
linkUrlStringL'URL del link impostato.

Invio

RichTextValueBuilder: questo generatore, per l'accodamento.

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

NomeTipoDescrizione
linkUrlStringL'URL del link impostato.

Invio

RichTextValueBuilder: questo generatore, per l'accodamento.

setText(text)

Imposta il testo per questo valore e cancella qualsiasi stile di testo esistente. Quando crei un nuovo valore di testo ricco, questo metodo deve essere chiamato prima di setTextStyle(startOffset, endOffset, textStyle).

Parametri

NomeTipoDescrizione
textStringIl testo per questo valore.

Invio

RichTextValueBuilder: questo generatore, per l'accodamento.

setTextStyle(startOffset, endOffset, textStyle)

Applica uno stile di testo alla sottostringa specificata di questo valore. Gli offset hanno come base 0 e sono relativi al valore di testo della cella. Non fa nulla 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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale per la sottostringa, incluso.
endOffsetIntegerLo spostamento di fine per la sottostringa, escluso.
textStyleTextStyleLo stile di testo impostato.

Invio

RichTextValueBuilder: questo generatore, per l'accodamento.

setTextStyle(textStyle)

Applica uno stile di testo all'intero valore. Gli stili di testo impostati in precedenza sono interessati solo se vengono sovrascritti direttamente dai valori all'interno di textStyle. Non fa nulla 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

NomeTipoDescrizione
textStyleTextStyleLo stile di testo impostato.

Invio

RichTextValueBuilder: questo generatore, per l'accodamento.