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 muestraDescripció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 el texto tiene varios estilos.
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 con 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 capitales pequeñas.
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

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

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

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 el texto tiene varios estilos.

Volver

Number|null

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

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

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

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

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

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

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

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

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

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

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

setBackgroundColor(color)

Establece el color de fondo del texto.

Parámetros

NombreTipoDescripción
colorColor

Volver

TextStyle

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
redInteger
greenInteger
blueInteger

Volver

TextStyle

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 representaría como "#FFC0CB".

Parámetros

NombreTipoDescripción
hexColorString

Volver

TextStyle

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
colorThemeColorType

Volver

TextStyle

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

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
offsetTextBaselineOffset

Volver

TextStyle

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.

Cambiar la negrita del texto actualiza el peso de la fuente que se usa para renderizar el texto.

Parámetros

NombreTipoDescripción
boldBoolean

Volver

TextStyle

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
fontFamilyString

Volver

TextStyle

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.

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").

Parámetros

NombreTipoDescripción
fontFamilyString
fontWeightInteger

Volver

TextStyle

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
fontSizeNumber

Volver

TextStyle

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
foregroundColorColor

Volver

TextStyle

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
redInteger
greenInteger
blueInteger

Volver

TextStyle

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 representaría como "#FFC0CB".

Parámetros

NombreTipoDescripción
hexColorString

Volver

TextStyle

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
colorThemeColorType

Volver

TextStyle

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
italicBoolean

Volver

TextStyle

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 con 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 los 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

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 los 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

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 los 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
slidePositionSlidePositionEs el SlidePosition relativo.

Volver

TextStyle

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 los 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

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 capitales pequeñas.

Parámetros

NombreTipoDescripción
smallCapsBoolean

Volver

TextStyle

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
strikethroughBoolean

Volver

TextStyle

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
underlineBoolean

Volver

TextStyle

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