Class TextStyle

TextStyle

Es el estilo del texto.

Los métodos de lectura de esta clase muestran null si el TextRange correspondiente abarca varias ejecuciones de texto y esas ejecuciones tienen valores diferentes para el método de lectura al que se llama. Para evitar esto, consulta los estilos de texto con los TextRange que devuelve el método TextRange.getRuns().

Si usas métodos que editan la forma en que el texto se ajusta 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()ColorDevuelve el color de fondo del texto o null si hay varios estilos en el texto.
getBaselineOffset()TextBaselineOffsetDevuelve el desplazamiento vertical del texto desde su posición normal, o null si hay varios estilos en el texto.
getFontFamily()StringDevuelve la familia de fuentes del texto o null si hay varios estilos en el texto.
getFontSize()NumberMuestra el tamaño de fuente del texto en puntos o null si hay varios estilos en el texto.
getFontWeight()IntegerDevuelve el grosor de la fuente del texto o null si hay varios estilos en el texto.
getForegroundColor()ColorDevuelve el color de primer plano del texto o null si hay varios estilos en el texto.
getLink()LinkMuestra el Link en el texto, o null si no hay vínculos, si el vínculo está en parte del texto o si hay varios vínculos.
hasLink()BooleanMuestra true si hay un vínculo en el texto, false si no hay uno o null si el vínculo está en parte del texto o si hay varios vínculos.
isBackgroundTransparent()BooleanMuestra true si el fondo del texto es transparente, false si no lo es o null si hay varios estilos en el texto.
isBold()BooleanMuestra true si el texto se renderiza en negrita, false si no, o null si hay varios estilos en el texto.
isItalic()BooleanMuestra true si el texto está en cursiva, false si no, o null si hay varios estilos en el texto.
isSmallCaps()BooleanMuestra true si el texto está en mayúsculas pequeñas, false si no, o null si hay varios estilos en el texto.
isStrikethrough()BooleanMuestra true si el texto está tachado, false si no, o null si hay varios estilos en el texto.
isUnderline()BooleanMuestra true si el texto está subrayado, false si no, 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 dados de 0 a 255.
setBackgroundColor(hexColor)TextStyleEstablece el color de fondo del texto en la cadena de color hexadecimal especificada.
setBackgroundColor(color)TextStyleEstablece el color de fondo del texto en el ThemeColorType determinado.
setBackgroundColorTransparent()TextStyleEstablece el color de fondo del texto en 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 de fuentes y el grosor del texto.
setFontSize(fontSize)TextStyleEstablece el tamaño de fuente del texto, en puntos.
setForegroundColor(foregroundColor)TextStyleEstablece el color del primer plano del texto.
setForegroundColor(red, green, blue)TextStyleEstablece el color de primer plano del texto en los valores RGB dados de 0 a 255.
setForegroundColor(hexColor)TextStyleEstablece el color de primer plano del texto en la cadena de color hexadecimal especificada.
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 Link en el 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 con la posición relativa de la diapositiva.
setLinkUrl(url)TextStyleEstablece un Link en la cadena de URL no vacía que se proporciona.
setSmallCaps(smallCaps)TextStyleEstablece si el texto se renderiza en mayúsculas 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

Autorización

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

  • 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

Autorización

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

  • 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

Autorización

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

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

getFontSize()

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

Volver

Number

Autorización

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

  • 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 descritos en la especificación CSS 2.1, sección 15.6, sin valores no numéricos. Los grosores mayores o iguales a 700 se consideran en negrita, en cuyo caso isBold() muestra true. El valor predeterminado es 400 (“normal”).

Volver

Integer

Autorización

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

  • 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

Autorización

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

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

Muestra el Link en el texto, o null si no hay vínculos, 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 un vínculo. 

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

Autorización

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

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

Muestra true si hay un vínculo en el texto, false si no hay uno o null si el vínculo está 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 el TextRange contiene un carácter de línea nueva, este método siempre muestra null o false.

Volver

Boolean

Autorización

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

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

isBackgroundTransparent()

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

Volver

Boolean

Autorización

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

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

isBold()

Muestra true si el texto se renderiza en negrita, false si no, o null si hay varios estilos en el texto.

Volver

Boolean

Autorización

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

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

isItalic()

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

Volver

Boolean

Autorización

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

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

isSmallCaps()

Muestra true si el texto está en mayúsculas pequeñas, false si no, o null si hay varios estilos en el texto.

Volver

Boolean

Autorización

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

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

isStrikethrough()

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

Volver

Boolean

Autorización

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

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

isUnderline()

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

Volver

Boolean

Autorización

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

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

Quita un Link.

Si quitas un vínculo, se quitarán el color de primer plano y el estilo de subrayado del hipervínculo en el 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 ámbitos:

  • 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 dados 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 ámbitos:

  • 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 especificada.

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 ámbitos:

  • 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 ámbitos:

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

setBackgroundColorTransparent()

Establece el color de fondo del texto en 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 ámbitos:

  • 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 ámbitos:

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

setBold(bold)

Establece si el texto se debe renderizar en negrita.

Si cambias el estilo de negrita del texto, se actualiza el grosor de la fuente que se usa para renderizarlo.

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 ámbitos:

  • 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 ámbitos:

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

setFontFamilyAndWeight(fontFamily, fontWeight)

Establece la familia de fuentes y el grosor del texto.

El peso es un múltiplo de 100 entre 100 y 900 inclusive. Este rango corresponde a los valores numéricos descritos en la especificación CSS 2.1, sección 15.6, sin valores no numéricos. Los grosores mayores o iguales a 700 se consideran en negrita, en cuyo caso isBold() muestra 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 ámbitos:

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

setFontSize(fontSize)

Establece el tamaño de 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 ámbitos:

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

setForegroundColor(foregroundColor)

Establece el color del 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 ámbitos:

  • 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 dados 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 ámbitos:

  • 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 especificada.

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 ámbitos:

  • 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 ámbitos:

  • 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 ámbitos:

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

setLinkSlide(slideIndex)

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

Si configuras un vínculo, se 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, se ignoran los caracteres de salto de línea 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
slideIndexIntegerEs el í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 ámbitos:

  • 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.

Si configuras un vínculo, se 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, se ignoran los caracteres de salto de línea 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
slideSlideEl 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 ámbitos:

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

setLinkSlide(slidePosition)

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

Si configuras un vínculo, se 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, se ignoran los caracteres de salto de línea 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

Autorización

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

  • 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 que se proporciona.

Si configuras un vínculo, se 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, se ignoran los caracteres de salto de línea 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 ámbitos:

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

setSmallCaps(smallCaps)

Establece si el texto se renderiza en mayúsculas 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 ámbitos:

  • 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 ámbitos:

  • 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 ámbitos:

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