Class TextStyle

TextStyle

Es el estilo del texto.

Los métodos de lectura de esta clase devuelven null si los tramos TextRange correspondientes abarcan varios tramos de texto y esos tramos tienen valores diferentes para el método de lectura que se llama. Para evitar esto, consulta los estilos de texto con los TextRanges que devuelve el método TextRange.getRuns().

Si usas métodos que editan cómo se ajusta el texto dentro de una forma, se desactivará cualquier configuración de ajuste automático aplicada a los estilos de texto.

Métodos

MétodoTipo de datos que se devuelveDescripción breve
getBackgroundColor()Color|nullDevuelve el color de fondo del texto o null si hay varios estilos en el texto.
getBaselineOffset()TextBaselineOffset|nullDevuelve el desplazamiento vertical del texto desde su posición normal o null si hay varios estilos en el texto.
getFontFamily()String|nullDevuelve la familia de fuentes del texto o null si hay varios estilos en el texto.
getFontSize()Number|nullDevuelve el tamaño de fuente del texto en puntos o null si hay varios estilos en el texto.
getFontWeight()Integer|nullDevuelve el grosor de la fuente del texto o null si hay varios estilos en el texto.
getForegroundColor()Color|nullDevuelve el color de primer plano del texto o null si hay varios estilos en el texto.
getLink()Link|nullDevuelve el Link en el texto o null si no hay un vínculo, si el vínculo está en parte del texto o si hay varios vínculos.
hasLink()Boolean|nullDevuelve true si hay un vínculo en el texto, false si no lo hay o null si el vínculo se encuentra en parte del texto o si hay varios vínculos.
isBackgroundTransparent()Boolean|nullDevuelve true si el fondo del texto es transparente, false si no lo es o null si hay varios estilos en el texto.
isBold()Boolean|nullDevuelve true si el texto se renderiza en negrita, false si no es así o null si hay varios estilos en el texto.
isItalic()Boolean|nullDevuelve true si el texto está en cursiva, false si no lo está o null si hay varios estilos en el texto.
isSmallCaps()Boolean|nullDevuelve true si el texto está en letras pequeñas en mayúscula, false si no lo está o null si hay varios estilos en el texto.
isStrikethrough()Boolean|nullDevuelve true si el texto está tachado, false si no lo está o null si hay varios estilos en el texto.
isUnderline()Boolean|nullDevuelve true si el texto está subrayado, false si no lo está o null si hay varios estilos en el texto.
removeLink()TextStyleQuita un Link.
setBackgroundColor(color)TextStyleEstablece el color de fondo del texto.
setBackgroundColor(red, green, blue)TextStyleEstablece el color de fondo del texto en los valores RGB proporcionados, que van de 0 a 255.
setBackgroundColor(hexColor)TextStyleEstablece el color de fondo del texto en la cadena de color hexadecimal proporcionada.
setBackgroundColor(color)TextStyleEstablece el color de fondo del texto en el ThemeColorType determinado.
setBackgroundColorTransparent()TextStyleEstablece el color de fondo del texto como transparente.
setBaselineOffset(offset)TextStyleEstablece el desplazamiento vertical del texto en relación con su posición normal.
setBold(bold)TextStyleEstablece si el texto se debe renderizar en negrita.
setFontFamily(fontFamily)TextStyleEstablece la familia de fuentes del texto .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleEstablece la familia y el peso de la fuente del texto.
setFontSize(fontSize)TextStyleEstablece el tamaño de la fuente del texto en puntos.
setForegroundColor(foregroundColor)TextStyleEstablece el color de primer plano del texto.
setForegroundColor(red, green, blue)TextStyleEstablece el color de primer plano del texto en los valores RGB proporcionados, que van de 0 a 255.
setForegroundColor(hexColor)TextStyleEstablece el color de primer plano del texto en la cadena de color hexadecimal proporcionada.
setForegroundColor(color)TextStyleEstablece el color de primer plano del texto en el ThemeColorType determinado.
setItalic(italic)TextStyleEstablece si el texto está en cursiva.
setLinkSlide(slideIndex)TextStyleEstablece un objeto Link en el objeto Slide determinado usando el índice basado en cero de la diapositiva.
setLinkSlide(slide)TextStyleEstablece un Link en el Slide determinado. El vínculo se establece con el ID de diapositiva determinado.
setLinkSlide(slidePosition)TextStyleEstablece un Link en el Slide determinado usando la posición relativa de la diapositiva.
setLinkUrl(url)TextStyleEstablece un Link en la cadena de URL no vacía proporcionada.
setSmallCaps(smallCaps)TextStyleEstablece si el texto se renderiza en letras pequeñas capitalizadas.
setStrikethrough(strikethrough)TextStyleEstablece si el texto está tachado.
setUnderline(underline)TextStyleEstablece si el texto está subrayado.

Documentación detallada

getBackgroundColor()

Devuelve el color de fondo del texto o null si hay varios estilos en el texto.

Volver

Color|null: Es el color de fondo del texto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getBaselineOffset()

Devuelve el desplazamiento vertical del texto desde su posición normal o null si hay varios estilos en el texto.

Volver

TextBaselineOffset|null: Es el desplazamiento vertical del texto desde su posición normal.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontFamily()

Devuelve la familia de fuentes del texto o null si hay varios estilos en el texto.

Volver

String|null: Es la familia de fuentes del texto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontSize()

Devuelve el tamaño de fuente del texto en puntos o null si hay varios estilos en el texto.

Volver

Number|null: Es el tamaño de la fuente del texto en puntos.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontWeight()

Devuelve el grosor de la fuente del texto o null si hay varios estilos en el texto.

El peso es un múltiplo de 100 entre 100 y 900, inclusive. Este rango corresponde a los valores numéricos que se describen en la especificación de CSS 2.1, sección 15.6, y no se permiten valores no numéricos. Los pesos mayores o iguales a 700 se consideran negrita, en cuyo caso isBold() devuelve true. El valor predeterminado es 400 ("normal").

Volver

Integer|null: Es el grosor de la fuente del texto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getForegroundColor()

Devuelve el color de primer plano del texto o null si hay varios estilos en el texto.

Volver

Color|null: Es el color de primer plano del texto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Devuelve el Link en el texto o null si no hay un vínculo, si el vínculo está en parte del texto o si hay varios vínculos. Llama a hasLink() para determinar si el texto no tiene vínculos. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`);
}

Volver

Link|null: Es el vínculo en el texto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Devuelve true si hay un vínculo en el texto, false si no lo hay o null si el vínculo se encuentra en parte del texto o si hay varios vínculos.

No se pueden establecer vínculos en caracteres de salto de línea. Por lo tanto, si TextRange contiene un carácter de nueva línea, este método siempre devuelve null o false.

Volver

Boolean|null: Indica si hay un vínculo en el texto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isBackgroundTransparent()

Devuelve true si el fondo del texto es transparente, false si no lo es o null si hay varios estilos en el texto.

Volver

Boolean|null: Indica si el fondo del texto es transparente.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isBold()

Devuelve true si el texto se renderiza en negrita, false si no es así o null si hay varios estilos en el texto.

Volver

Boolean|null: Indica si el texto se renderiza en negrita.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isItalic()

Devuelve true si el texto está en cursiva, false si no lo está o null si hay varios estilos en el texto.

Volver

Boolean|null: Indica si el texto está en cursiva.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isSmallCaps()

Devuelve true si el texto está en letras pequeñas en mayúscula, false si no lo está o null si hay varios estilos en el texto.

Volver

Boolean|null: Indica si el texto está en letras pequeñas en mayúsculas.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isStrikethrough()

Devuelve true si el texto está tachado, false si no lo está o null si hay varios estilos en el texto.

Volver

Boolean|null: Indica si el texto está tachado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isUnderline()

Devuelve true si el texto está subrayado, false si no lo está o null si hay varios estilos en el texto.

Volver

Boolean|null: Indica si el texto está subrayado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Quita un Link.

Quitar un vínculo quita el color de primer plano del hipervínculo y el estilo de subrayado del texto. Si es posible, estos estilos se aplican para que coincidan con el texto que precede al vínculo. 

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

Volver

TextStyle: Este TextStyle, para el encadenamiento.

setBackgroundColor(color)

Establece el color de fondo del texto.

Parámetros

NombreTipoDescripción
colorColorColor de fondo que se establecerá.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(red, green, blue)

Establece el color de fondo del texto en los valores RGB proporcionados, que van de 0 a 255.

Parámetros

NombreTipoDescripción
redIntegerEs el componente rojo del color.
greenIntegerEs el componente verde del color.
blueIntegerEs el componente azul del color.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(hexColor)

Establece el color de fondo del texto en la cadena de color hexadecimal proporcionada.

La cadena hexadecimal debe tener el formato "#RRGGBB". Por ejemplo, el rosa se representa como

Parámetros

NombreTipoDescripción
hexColorStringEs la cadena de color hexadecimal.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(color)

Establece el color de fondo del texto en el ThemeColorType determinado.

Parámetros

NombreTipoDescripción
colorThemeColorTypeEs el tipo de color del tema.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColorTransparent()

Establece el color de fondo del texto como transparente.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBaselineOffset(offset)

Establece el desplazamiento vertical del texto en relación con su posición normal.

Parámetros

NombreTipoDescripción
offsetTextBaselineOffsetEs el desplazamiento del modelo de referencia que se establecerá.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBold(bold)

Establece si el texto se debe renderizar en negrita.

Parámetros

NombreTipoDescripción
boldBooleanIndica si se debe renderizar el texto en negrita.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontFamily(fontFamily)

Establece la familia de fuentes del texto .

Parámetros

NombreTipoDescripción
fontFamilyStringFamilia de fuentes que se establecerá.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontFamilyAndWeight(fontFamily, fontWeight)

Establece la familia y el peso de la fuente del texto.

Parámetros

NombreTipoDescripción
fontFamilyStringFamilia de fuentes.
fontWeightIntegerEs el grosor de la fuente.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontSize(fontSize)

Establece el tamaño de la fuente del texto en puntos.

Parámetros

NombreTipoDescripción
fontSizeNumberTamaño de la fuente en puntos.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(foregroundColor)

Establece el color de primer plano del texto.

Parámetros

NombreTipoDescripción
foregroundColorColorColor de primer plano que se establecerá.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(red, green, blue)

Establece el color de primer plano del texto en los valores RGB proporcionados, que van de 0 a 255.

Parámetros

NombreTipoDescripción
redIntegerEs el componente rojo del color.
greenIntegerEs el componente verde del color.
blueIntegerEs el componente azul del color.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(hexColor)

Establece el color de primer plano del texto en la cadena de color hexadecimal proporcionada.

La cadena hexadecimal debe tener el formato "#RRGGBB". Por ejemplo, el rosa se representa como

Parámetros

NombreTipoDescripción
hexColorStringEs la cadena de color hexadecimal.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(color)

Establece el color de primer plano del texto en el ThemeColorType determinado.

Parámetros

NombreTipoDescripción
colorThemeColorTypeEs el tipo de color del tema.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setItalic(italic)

Establece si el texto está en cursiva.

Parámetros

NombreTipoDescripción
italicBooleanIndica si se debe renderizar el texto en cursiva.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slideIndex)

Establece un objeto Link en el objeto Slide determinado usando el índice basado en cero de la diapositiva.

Establecer un vínculo cambia el estilo del texto para que esté subrayado y tenga un color de primer plano ThemeColorType.HYPERLINK. Esto se puede cambiar a través de setForegroundColor(hexColor) y setUnderline(underline).

Dado que no se pueden establecer vínculos en caracteres de salto de línea, estos se ignoran en TextRange. 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(0);

Parámetros

NombreTipoDescripción
slideIndexIntegerÍndice basado en cero de la diapositiva.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slide)

Establece un Link en el Slide determinado. El vínculo se establece con el ID de diapositiva determinado.

Establecer un vínculo cambia el estilo del texto para que esté subrayado y tenga un color de primer plano ThemeColorType.HYPERLINK. Esto se puede cambiar a través de setForegroundColor(hexColor) y setUnderline(underline).

Dado que no se pueden establecer vínculos en caracteres de salto de línea, estos se ignoran en TextRange. 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(slide);

Parámetros

NombreTipoDescripción
slideSlideEs el Slide que se vinculará.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slidePosition)

Establece un Link en el Slide determinado usando la posición relativa de la diapositiva.

Establecer un vínculo cambia el estilo del texto para que esté subrayado y tenga un color de primer plano ThemeColorType.HYPERLINK. Esto se puede cambiar a través de setForegroundColor(hexColor) y setUnderline(underline).

Dado que no se pueden establecer vínculos en caracteres de salto de línea, estos se ignoran en TextRange. 

// Set a link to the first slide of the presentation.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parámetros

NombreTipoDescripción
slidePositionSlidePositionEl SlidePosition relativo.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkUrl(url)

Establece un Link en la cadena de URL no vacía proporcionada.

Establecer un vínculo cambia el estilo del texto para que esté subrayado y tenga un color de primer plano ThemeColorType.HYPERLINK. Esto se puede cambiar a través de setForegroundColor(hexColor) y setUnderline(underline).

Dado que no se pueden establecer vínculos en caracteres de salto de línea, estos se ignoran en TextRange. 

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

Parámetros

NombreTipoDescripción
urlStringEs la cadena de URL.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setSmallCaps(smallCaps)

Establece si el texto se renderiza en letras pequeñas capitalizadas.

Parámetros

NombreTipoDescripción
smallCapsBooleanIndica si se debe renderizar el texto en letras pequeñas capitalizadas.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setStrikethrough(strikethrough)

Establece si el texto está tachado.

Parámetros

NombreTipoDescripción
strikethroughBooleanIndica si se debe tachar el texto.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setUnderline(underline)

Establece si el texto está subrayado.

Parámetros

NombreTipoDescripción
underlineBooleanIndica si se debe subrayar el texto.

Volver

TextStyle: Este TextStyle, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations