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.
Invio
RichTextValue
: un valore RTF creato da questo strumento per la creazione di contenuti.
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, incluso. |
endOffset | Integer | L'offset finale della sottostringa, escluso. |
linkUrl | String | L'URL del link da impostare. |
Invio
RichTextValueBuilder
: questo builder, 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. |
Invio
RichTextValueBuilder
: questo builder, per il concatenamento.
setText(text)
Imposta il testo per questo valore e cancella qualsiasi stile di testo esistente. Quando crei un nuovo RTF
, questo dovrebbe essere chiamato prima di setTextStyle(startOffset, endOffset, textStyle)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo di questo valore. |
Invio
RichTextValueBuilder
: questo builder, 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 fa nulla se textStyle
è 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();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale per la sottostringa, incluso. |
endOffset | Integer | L'offset finale della sottostringa, escluso. |
textStyle | TextStyle | Lo stile del testo impostato. |
Invio
RichTextValueBuilder
: questo builder, per il concatenamento.
setTextStyle(textStyle)
Applica uno stile di testo all'intero valore. Gli stili di testo impostati in precedenza vengono applicati soltanto se
vengono sovrascritte 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. 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();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
textStyle | TextStyle | Lo stile del testo impostato. |
Invio
RichTextValueBuilder
: questo builder, per il concatenamento.