Es un compilador para valores de texto enriquecido.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
build() | RichTextValue | Crea un valor de texto enriquecido a partir de este compilador. |
setLinkUrl(startOffset, endOffset, linkUrl) | RichTextValueBuilder | Establece la URL del vínculo para la subcadena especificada de este valor o la borra si linkUrl es
null |
setLinkUrl(linkUrl) | RichTextValueBuilder | Establece la URL del vínculo para todo el valor o la borra si linkUrl es null . |
setText(text) | RichTextValueBuilder | Establece el texto de este valor y borra cualquier estilo de texto existente. |
setTextStyle(startOffset, endOffset, textStyle) | RichTextValueBuilder | Aplica un estilo de texto a la subcadena especificada de este valor. |
setTextStyle(textStyle) | RichTextValueBuilder | Aplica un estilo de texto a todo el valor. |
Documentación detallada
build()
Crea un valor de texto enriquecido a partir de este compilador.
Volver
RichTextValue
: Es un valor de texto enriquecido creado a partir de este compilador.
setLinkUrl(startOffset, endOffset, linkUrl)
Establece la URL del vínculo para la subcadena especificada de este valor o la borra si linkUrl
es
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();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento inicial de la subcadena, inclusive. |
endOffset | Integer | El desplazamiento final de la subcadena, exclusivo. |
linkUrl | String | La URL del vínculo que se está configurando. |
Volver
RichTextValueBuilder
: Este compilador, para encadenamiento,
setLinkUrl(linkUrl)
Establece la URL del vínculo para todo el valor o la borra si linkUrl
es 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();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
linkUrl | String | La URL del vínculo que se está configurando. |
Volver
RichTextValueBuilder
: Este compilador, para encadenamiento,
setText(text)
Establece el texto de este valor y borra cualquier estilo de texto existente. Al crear un nuevo texto enriquecido
de salida, se debe llamar antes de setTextStyle(startOffset, endOffset, textStyle)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Es el texto de este valor. |
Volver
RichTextValueBuilder
: Este compilador, para encadenamiento,
setTextStyle(startOffset, endOffset, textStyle)
Aplica un estilo de texto a la subcadena especificada de este valor. Las compensaciones se basan en 0 y son relativas
al valor de texto de la celda. No hace nada si textStyle
es 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();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento inicial de la subcadena, inclusive. |
endOffset | Integer | El desplazamiento final de la subcadena, exclusivo. |
textStyle | TextStyle | Es el estilo de texto que se establece. |
Volver
RichTextValueBuilder
: Este compilador, para encadenamiento,
setTextStyle(textStyle)
Aplica un estilo de texto a todo el valor. Los estilos de texto establecidos anteriormente solo se ven afectados si
se reemplazan directamente con los valores dentro de textStyle
. No hace nada si textStyle
es 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();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
textStyle | TextStyle | Es el estilo de texto que se establece. |
Volver
RichTextValueBuilder
: Este compilador, para encadenamiento,