Class TextStyle

TextStyle

El estilo del texto.

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

Si usas métodos que editan cómo se ajusta el texto a una forma, cualquier configuración de ajuste automático que se aplique a la estilos de texto están desactivados.

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 la 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()NumberDevuelve 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 este.
getForegroundColor()ColorDevuelve el color de primer plano del texto o null si hay varios estilos en la texto.
getLink()LinkMuestra el Link en el texto, o null si no hay un vínculo o si el vínculo está activado. parte del texto o si hay varios vínculos.
hasLink()BooleanMuestra true si hay un vínculo en el texto, false si no es así o null si el elemento aparece en parte del texto o hay varios vínculos.
isBackgroundTransparent()BooleanMuestra true si el fondo del texto es transparente; si no lo es, muestra false. 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 no lo está. hay varios estilos en el texto.
isItalic()BooleanMuestra true si el texto está en cursiva, false si no está presente o null si la hay. varios estilos en el texto.
isSmallCaps()BooleanMuestra true si el texto está en mayúsculas, false si no es así o null si el texto tiene varios estilos.
isStrikethrough()BooleanMuestra true si el texto está tachado, false si no es así o null si está tachado. hay varios estilos en el texto.
isUnderline()BooleanMuestra true si el texto está subrayado, false si no está o null si la 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 especificados 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 con relación a 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)TextStyleFija 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 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 Link en el Slide determinado con el índice basado en cero de la diapositiva.
setLinkSlide(slide)TextStyleEstablece un Link para la Slide determinada, el vínculo se establece con el ID de diapositiva dado.
setLinkSlide(slidePosition)TextStyleEstablece un elemento Link en el elemento Slide determinado usando la posición relativa de la diapositiva.
setLinkUrl(url)TextStyleConfigura un Link para una cadena de URL que no está vacía.
setSmallCaps(smallCaps)TextStyleEstablece si el texto se renderiza en minúsculas.
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 la 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 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.

Volver

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.

Volver

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

Devuelve 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 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 este.

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 no se permiten los valores no numéricos. Los pesos superiores o iguales a 700 se consideran en negrita, en En este 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 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 la 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 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á activado. 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());
}

Volver

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 es así o null si el elemento aparece en parte del texto o hay varios vínculos.

No se pueden establecer vínculos en caracteres de línea nueva. Por lo tanto, si TextRange contiene un carácter de salto de línea, 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 alcances:

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

isBackgroundTransparent()

Muestra true si el fondo del texto es transparente; si no lo es, muestra false. 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 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 no lo está. 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 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 está presente o null si la 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 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 es así o null si el texto tiene varios estilos.

Volver

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 lo está o null si está tachado. 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 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 está o null si la 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 alcances:

  • 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 del hipervínculo y el estilo de subrayado del texto. Si posible, estos estilos se aplican para coincidir con el texto que antecede al vínculo. 

text.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 especificados 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 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 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 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 alcances:

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

setBaselineOffset(offset)

Establece el desplazamiento vertical del texto con relación a 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.

Si cambias la 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 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 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 no se permiten los valores no numéricos. Los pesos superiores o iguales a 700 se consideran en negrita, en En este 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 alcances:

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

setFontSize(fontSize)

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

Cuando configuras un vínculo, se cambia 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 establecer en caracteres de nueva línea, los caracteres de salto de línea en TextRange se ignoran. 

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

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 para la Slide determinada, el vínculo se establece con el ID de diapositiva dado.

Cuando configuras un vínculo, se cambia 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 establecer en caracteres de nueva línea, los caracteres de salto de línea en TextRange se ignoran. 

// 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á.

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

Cuando configuras un vínculo, se cambia 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 establecer en caracteres de nueva línea, los caracteres de salto de línea en TextRange se ignoran. 

// Set a link to the first slide of the presentation.
text.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)

Configura un Link para una cadena de URL que no está vacía.

Cuando configuras un vínculo, se cambia 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 establecer en caracteres de nueva línea, los caracteres de salto de línea en TextRange se ignoran. 

// Set a link to the URL.
text.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 minúsculas.

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