Class TextStyle

TextStyle

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 estilos de texto con los TextRange que muestra el método TextRange.getRuns().

Si usas métodos que editan la forma en que el texto se ajusta a 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()ColorMuestra el color de fondo del texto o null si hay varios estilos en el texto.
getBaselineOffset()TextBaselineOffsetMuestra el desplazamiento vertical del texto desde su posición normal o null si hay varios estilos en el texto.
getFontFamily()StringMuestra 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()IntegerMuestra el grosor de la fuente del texto o null si hay varios estilos en el texto.
getForegroundColor()ColorMuestra 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 un vínculo o si el vínculo está en una parte del texto o si hay varios vínculos.
hasLink()BooleanMuestra true si hay un vínculo en el texto, false si no o null si el vínculo forma parte del texto o 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 es así o null si hay varios estilos en el texto.
isItalic()BooleanMuestra true si el texto está en cursiva, false si no es así o null si hay varios estilos en el texto.
isSmallCaps()BooleanMuestra true si el texto está en mayúsculas, 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 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 con los valores RGB especificados de 0 a 255.
setBackgroundColor(hexColor)TextStyleEstablece el color de fondo del texto en la string 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 representar 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 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 con los valores RGB especificados 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 elemento 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 mediante el ID de diapositiva especificado.
setLinkSlide(slidePosition)TextStyleEstablece un elemento Link en el Slide determinado utilizando la posición relativa de la diapositiva.
setLinkUrl(url)TextStyleEstablece una Link en la string de URL especificada que no está vacía.
setSmallCaps(smallCaps)TextStyleEstablece si el texto se renderiza en letras mayúsculas pequeñas.
setStrikethrough(strikethrough)TextStyleEstablece si el texto se tachará.
setUnderline(underline)TextStyleEstablece si el texto está subrayado.

Documentación detallada

getBackgroundColor()

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

Devolvedor

Color

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()

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

Devolvedor

TextBaselineOffset

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()

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

Devolvedor

String

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()

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

Devolvedor

Number

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()

Muestra 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 sección 15.6 de la Especificación CSS 2.1, con valores no numéricos no permitidos. Los pesos superiores o iguales a 700 se consideran en negrita, en cuyo caso isBold() muestra true. El valor predeterminado es 400 ("normal").

Devolvedor

Integer

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()

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

Devolvedor

Color

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

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

var textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log('Shape text has a link of type: ' + textLink.getLinkType());
}

Devolvedor

Link

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

Muestra true si hay un vínculo en el texto, false si no o null si el vínculo forma parte del texto o 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 salto de línea, este método siempre muestra null o false.

Devolvedor

Boolean

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()

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

Devolvedor

Boolean

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()

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

Devolvedor

Boolean

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()

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

Devolvedor

Boolean

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()

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

Devolvedor

Boolean

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()

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

Devolvedor

Boolean

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()

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

Devolvedor

Boolean

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.

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

text.getTextStyle().removeLink();

Devolvedor

TextStyle


setBackgroundColor(color)

Establece el color de fondo del texto.

Parámetros

NombreTipoDescripción
colorColor

Devolvedor

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 con los valores RGB especificados de 0 a 255.

Parámetros

NombreTipoDescripción
redInteger
greenInteger
blueInteger

Devolvedor

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 string de color hexadecimal especificada.

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

Parámetros

NombreTipoDescripción
hexColorString

Devolvedor

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

Devolvedor

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 en transparente.

Devolvedor

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

Devolvedor

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 representar en negrita.

Si cambias la negrita del texto, se actualizará el grosor de la fuente que se usó para renderizarlo.

Parámetros

NombreTipoDescripción
boldBoolean

Devolvedor

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

Devolvedor

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 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 sección 15.6 de la Especificación CSS 2.1, con valores no numéricos no permitidos. Los pesos superiores 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

Devolvedor

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

Devolvedor

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

Devolvedor

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 con los valores RGB especificados de 0 a 255.

Parámetros

NombreTipoDescripción
redInteger
greenInteger
blueInteger

Devolvedor

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

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

Parámetros

NombreTipoDescripción
hexColorString

Devolvedor

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

Devolvedor

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

Devolvedor

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 elemento Link en el Slide determinado con el índice basado en cero de la diapositiva.

Si configuras un vínculo, se modificará el estilo del texto que se subrayará y tendrá un color de primer plano ThemeColorType.HYPERLINK. Esto se puede cambiar mediante setForegroundColor(hexColor) y setUnderline(underline).

Como los vínculos no se pueden configurar 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.
text.getTextStyle().setLinkSlide(0);

Parámetros

NombreTipoDescripción
slideIndexIntegerEl índice basado en cero de la diapositiva.

Devolvedor

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 mediante el ID de diapositiva especificado.

Si configuras un vínculo, se modificará el estilo del texto que se subrayará y tendrá un color de primer plano ThemeColorType.HYPERLINK. Esto se puede cambiar mediante setForegroundColor(hexColor) y setUnderline(underline).

Como los vínculos no se pueden configurar 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.
var slide = presentation.getSlides()[0];
text.getTextStyle().setLinkSlide(slide);

Parámetros

NombreTipoDescripción
slideSlideEl Slide que se vinculará.

Devolvedor

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 elemento Link en el Slide determinado utilizando la posición relativa de la diapositiva.

Si configuras un vínculo, se modificará el estilo del texto que se subrayará y tendrá un color de primer plano ThemeColorType.HYPERLINK. Esto se puede cambiar mediante setForegroundColor(hexColor) y setUnderline(underline).

Como los vínculos no se pueden configurar 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.
text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parámetros

NombreTipoDescripción
slidePositionSlidePositionEl SlidePosition relativo

Devolvedor

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 una Link en la string de URL especificada que no está vacía.

Si configuras un vínculo, se modificará el estilo del texto que se subrayará y tendrá un color de primer plano ThemeColorType.HYPERLINK. Esto se puede cambiar mediante setForegroundColor(hexColor) y setUnderline(underline).

Como los vínculos no se pueden configurar en caracteres de salto de línea, se ignoran los caracteres de salto de línea en TextRange.

// Set a link to the URL.
text.getTextStyle().setLinkUrl("https://slides.google.com");

Parámetros

NombreTipoDescripción
urlStringEs la string de la URL.

Devolvedor

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 mayúsculas pequeñas.

Parámetros

NombreTipoDescripción
smallCapsBoolean

Devolvedor

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 se tachará.

Parámetros

NombreTipoDescripción
strikethroughBoolean

Devolvedor

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

Devolvedor

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