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étodo | Tipo de datos que se muestra | Descripción breve |
---|---|---|
getBackgroundColor() | Color | Muestra el color de fondo del texto o null si hay varios estilos en el texto. |
getBaselineOffset() | TextBaselineOffset | Muestra el desplazamiento vertical del texto desde su posición normal o null si hay varios estilos en el texto. |
getFontFamily() | String | Muestra la familia de fuentes del texto o null si hay varios estilos en el texto. |
getFontSize() | Number | Muestra el tamaño de fuente del texto en puntos, o null si hay varios estilos en el texto. |
getFontWeight() | Integer | Muestra el grosor de la fuente del texto o null si hay varios estilos en el texto. |
getForegroundColor() | Color | Muestra el color de primer plano del texto o null si hay varios estilos en el texto. |
getLink() | Link | 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. |
hasLink() | Boolean | 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. |
isBackgroundTransparent() | Boolean | Muestra true si el fondo del texto es transparente, false si no lo es o null si hay varios estilos en el texto. |
isBold() | Boolean | Muestra true si el texto se renderiza en negrita, false si no es así o null si hay varios estilos en el texto. |
isItalic() | Boolean | Muestra true si el texto está en cursiva, false si no es así o null si hay varios estilos en el texto. |
isSmallCaps() | Boolean | Muestra true si el texto está en mayúsculas, false si no o null si hay varios estilos en el texto. |
isStrikethrough() | Boolean | Muestra true si el texto está tachado, false si no o null si hay varios estilos en el texto. |
isUnderline() | Boolean | Muestra true si el texto está subrayado, false si no lo está o null si hay varios estilos en el texto. |
removeLink() | TextStyle | Quita un Link . |
setBackgroundColor(color) | TextStyle | Establece el color de fondo del texto. |
setBackgroundColor(red, green, blue) | TextStyle | Establece el color de fondo del texto con los valores RGB especificados de 0 a 255. |
setBackgroundColor(hexColor) | TextStyle | Establece el color de fondo del texto en la string de color hexadecimal especificada. |
setBackgroundColor(color) | TextStyle | Establece el color de fondo del texto en el ThemeColorType determinado. |
setBackgroundColorTransparent() | TextStyle | Establece el color de fondo del texto en transparente. |
setBaselineOffset(offset) | TextStyle | Establece el desplazamiento vertical del texto en relación con su posición normal. |
setBold(bold) | TextStyle | Establece si el texto se debe representar en negrita. |
setFontFamily(fontFamily) | TextStyle | Establece la familia de fuentes del texto . |
setFontFamilyAndWeight(fontFamily, fontWeight) | TextStyle | Establece la familia de fuentes y el grosor del texto. |
setFontSize(fontSize) | TextStyle | Establece el tamaño de la fuente del texto en puntos. |
setForegroundColor(foregroundColor) | TextStyle | Establece el color de primer plano del texto. |
setForegroundColor(red, green, blue) | TextStyle | Establece el color de primer plano del texto con los valores RGB especificados de 0 a 255. |
setForegroundColor(hexColor) | TextStyle | Establece el color de primer plano del texto en la cadena de color hexadecimal especificada. |
setForegroundColor(color) | TextStyle | Establece el color de primer plano del texto en el ThemeColorType determinado. |
setItalic(italic) | TextStyle | Establece si el texto está en cursiva. |
setLinkSlide(slideIndex) | TextStyle | Establece un elemento Link en el Slide determinado con el índice basado en cero de la diapositiva. |
setLinkSlide(slide) | TextStyle | Establece un Link en el Slide determinado; el vínculo se establece mediante el ID de diapositiva especificado. |
setLinkSlide(slidePosition) | TextStyle | Establece un elemento Link en el Slide determinado utilizando la posición relativa de la diapositiva. |
setLinkUrl(url) | TextStyle | Establece una Link en la string de URL especificada que no está vacía. |
setSmallCaps(smallCaps) | TextStyle | Establece si el texto se renderiza en letras mayúsculas pequeñas. |
setStrikethrough(strikethrough) | TextStyle | Establece si el texto se tachará. |
setUnderline(underline) | TextStyle | Establece 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
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
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
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
getLink()
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
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
hasLink()
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
removeLink()
setBackgroundColor(color)
Establece el color de fondo del texto.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | Color |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
hexColor | String |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
color | ThemeColorType |
Devolvedor
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
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
Nombre | Tipo | Descripción |
---|---|---|
offset | TextBaselineOffset |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
bold | Boolean |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
fontFamily | String |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
fontSize | Number |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
foregroundColor | Color |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
hexColor | String |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
color | ThemeColorType |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
italic | Boolean |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
slideIndex | Integer | El índice basado en cero de la diapositiva. |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
slide | Slide | El Slide que se vinculará. |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
slidePosition | SlidePosition | El SlidePosition relativo |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
url | String | Es la string de la URL. |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
smallCaps | Boolean |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
strikethrough | Boolean |
Devolvedor
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
Nombre | Tipo | Descripción |
---|---|---|
underline | Boolean |
Devolvedor
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