O estilo do texto.
Os métodos de leitura nessa classe retornam null
se os TextRange
correspondentes abrangerem
múltiplas execuções de texto que tenham valores diferentes para o método de leitura que está sendo chamado. Para
Para evitar isso, consulte estilos de texto usando as TextRange
s retornadas pelo método TextRange.getRuns()
.
Se você usar métodos que editam como o texto se encaixa em uma forma, as configurações de ajuste automático aplicadas à estilos de texto sejam desativados.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
getBackgroundColor() | Color | Retorna a cor de fundo do texto ou null , se houver vários estilos no
em textos. |
getBaselineOffset() | TextBaselineOffset | Retorna o deslocamento vertical do texto da posição normal ou null se houver
vários estilos no texto. |
getFontFamily() | String | Retorna a família de fontes do texto ou null , se houver vários estilos no texto. |
getFontSize() | Number | Retorna o tamanho da fonte do texto em pontos ou null se houver vários estilos no
o texto. |
getFontWeight() | Integer | Retorna a espessura da fonte do texto ou null , se houver vários estilos no texto. |
getForegroundColor() | Color | Retorna a cor do primeiro plano do texto ou null , se houver vários estilos no
em textos. |
getLink() | Link | Retorna o Link no texto ou null se não houver um link ou se o link estiver ativado
parte do texto ou se houver vários links. |
hasLink() | Boolean | Retorna true se houver um link no texto, false se não houver, ou null se o
está em parte do texto ou há vários links. |
isBackgroundTransparent() | Boolean | Retorna true se o plano de fundo do texto for transparente, false se não for ou
null , se houver vários estilos no texto. |
isBold() | Boolean | Retorna true se o texto for renderizado como negrito, false se não for, ou null se
há vários estilos no texto. |
isItalic() | Boolean | Retorna true se o texto estiver em itálico, false se não estiver ou null se houver
há vários estilos no texto. |
isSmallCaps() | Boolean | Retorna true se o texto estiver em letras maiúsculas minúsculas, false se não estiver, ou null se houver vários estilos no texto. |
isStrikethrough() | Boolean | Retorna true se o texto estiver tachado, false se não tiver, ou null se estiver riscado
há vários estilos no texto. |
isUnderline() | Boolean | Retorna true se o texto estiver sublinhado, false se não estiver ou null se houver
há vários estilos no texto. |
removeLink() | TextStyle | Remove um Link . |
setBackgroundColor(color) | TextStyle | Define a cor de fundo do texto. |
setBackgroundColor(red, green, blue) | TextStyle | Define a cor de fundo do texto para os valores RGB fornecidos de 0 a 255. |
setBackgroundColor(hexColor) | TextStyle | Define a cor de fundo do texto como a string de cor hexadecimal especificada. |
setBackgroundColor(color) | TextStyle | Define a cor do plano de fundo do texto para o ThemeColorType especificado. |
setBackgroundColorTransparent() | TextStyle | Define a cor de fundo do texto como transparente. |
setBaselineOffset(offset) | TextStyle | Define o deslocamento vertical do texto em relação à posição normal. |
setBold(bold) | TextStyle | Define se o texto deve ser renderizado como negrito. |
setFontFamily(fontFamily) | TextStyle | Define a família de fontes do texto . |
setFontFamilyAndWeight(fontFamily, fontWeight) | TextStyle | Define a família de fontes e a espessura do texto. |
setFontSize(fontSize) | TextStyle | Define o tamanho da fonte do texto, em pontos. |
setForegroundColor(foregroundColor) | TextStyle | Define a cor do primeiro plano do texto. |
setForegroundColor(red, green, blue) | TextStyle | Define a cor do primeiro plano do texto como os valores RGB fornecidos de 0 a 255. |
setForegroundColor(hexColor) | TextStyle | Define a cor do primeiro plano do texto como a string de cor hexadecimal especificada. |
setForegroundColor(color) | TextStyle | Define a cor do primeiro plano do texto para o ThemeColorType especificado. |
setItalic(italic) | TextStyle | Define se o texto ficará em itálico. |
setLinkSlide(slideIndex) | TextStyle | Define um Link para o Slide especificado usando o índice baseado em zero do slide. |
setLinkSlide(slide) | TextStyle | Define um Link para o Slide especificado, o link é definido pelo ID do slide especificado. |
setLinkSlide(slidePosition) | TextStyle | Define um Link para o Slide especificado usando a posição relativa do slide. |
setLinkUrl(url) | TextStyle | Define um Link para a string de URL não vazia fornecida. |
setSmallCaps(smallCaps) | TextStyle | Define se o texto será renderizado em letras maiúsculas minúsculas. |
setStrikethrough(strikethrough) | TextStyle | Define se o texto é riscado. |
setUnderline(underline) | TextStyle | Define se o texto será sublinhado. |
Documentação detalhada
getBackgroundColor()
Retorna a cor de fundo do texto ou null
, se houver vários estilos no
em textos.
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getBaselineOffset()
Retorna o deslocamento vertical do texto da posição normal ou null
se houver
vários estilos no texto.
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontFamily()
Retorna a família de fontes do texto ou null
, se houver vários estilos no texto.
Retornar
String
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontSize()
Retorna o tamanho da fonte do texto em pontos ou null
se houver vários estilos no
o texto.
Retornar
Number
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontWeight()
Retorna a espessura da fonte do texto ou null
se houver vários estilos no texto.
O peso é um múltiplo de 100 entre 100 e 900. Esse intervalo corresponde a
os valores numéricos descritos na Especificação CSS 2.1, seção 15.6, com
valores não numéricos não permitidos. Pesos maiores ou iguais a 700 são considerados em negrito, na
caso em que isBold()
retorna true
. O valor padrão é 400.
("normal").
Retornar
Integer
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getForegroundColor()
Retorna a cor do primeiro plano do texto ou null
, se houver vários estilos no
em textos.
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Retorna o Link
no texto ou null
se não houver um link ou se o link estiver ativado
parte do texto ou se houver vários links. Chame hasLink()
para determinar se
o texto não tem link.
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
hasLink()
Retorna true
se houver um link no texto, false
se não houver, ou null
se o
está em parte do texto ou há vários links.
Não é possível definir links em caracteres de nova linha. Portanto, se o TextRange
contiver um
caractere de nova linha, esse método sempre retorna null
ou false
.
Retornar
Boolean
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isBackgroundTransparent()
Retorna true
se o plano de fundo do texto for transparente, false
se não for ou
null
, se houver vários estilos no texto.
Retornar
Boolean
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isBold()
Retorna true
se o texto for renderizado como negrito, false
se não for, ou null
se
há vários estilos no texto.
Retornar
Boolean
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isItalic()
Retorna true
se o texto estiver em itálico, false
se não estiver ou null
se houver
há vários estilos no texto.
Retornar
Boolean
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isSmallCaps()
Retorna true
se o texto estiver em letras maiúsculas minúsculas, false
se não estiver, ou null
se houver vários estilos no texto.
Retornar
Boolean
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isStrikethrough()
Retorna true
se o texto estiver tachado, false
se não tiver, ou null
se estiver riscado
há vários estilos no texto.
Retornar
Boolean
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isUnderline()
Retorna true
se o texto estiver sublinhado, false
se não estiver ou null
se houver
há vários estilos no texto.
Retornar
Boolean
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
Define a cor de fundo do texto para os valores RGB fornecidos de 0 a 255.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColor(hexColor)
Define a cor de fundo do texto como a string de cor hexadecimal especificada.
A string hexadecimal precisa estar no formato "#RRGGBB". Por exemplo, rosa seria representado como "#FFC0CB".
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
hexColor | String |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColor(color)
Define a cor do plano de fundo do texto para o ThemeColorType
especificado.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
color | ThemeColorType |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColorTransparent()
setBaselineOffset(offset)
Define o deslocamento vertical do texto em relação à posição normal.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
offset | TextBaselineOffset |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBold(bold)
Define se o texto deve ser renderizado como negrito.
Alterar o negrito do texto atualiza a espessura da fonte usada para renderizar o texto.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
bold | Boolean |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontFamily(fontFamily)
Define a família de fontes do texto .
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
fontFamily | String |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontFamilyAndWeight(fontFamily, fontWeight)
Define a família de fontes e a espessura do texto.
O peso é um múltiplo de 100 entre 100 e 900. Esse intervalo corresponde a
os valores numéricos descritos na Especificação CSS 2.1, seção 15.6, com
valores não numéricos não permitidos. Pesos maiores ou iguais a 700 são considerados em negrito, na
caso em que isBold()
retorna true
. O valor padrão é 400.
("normal").
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontSize(fontSize)
Define o tamanho da fonte do texto, em pontos.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
fontSize | Number |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(foregroundColor)
Define a cor do primeiro plano do texto.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
foregroundColor | Color |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(red, green, blue)
Define a cor do primeiro plano do texto como os valores RGB fornecidos de 0 a 255.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(hexColor)
Define a cor do primeiro plano do texto como a string de cor hexadecimal especificada.
A string hexadecimal precisa estar no formato "#RRGGBB". Por exemplo, rosa seria representado como "#FFC0CB".
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
hexColor | String |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(color)
Define a cor do primeiro plano do texto para o ThemeColorType
especificado.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
color | ThemeColorType |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setItalic(italic)
Define se o texto ficará em itálico.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
italic | Boolean |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Define um Link
para o Slide
especificado usando o índice baseado em zero do slide.
Definir um link muda o estilo do texto a ser sublinhado e fica com a cor de primeiro plano ThemeColorType.HYPERLINK
. Isso pode ser alterado via setForegroundColor(hexColor)
e setUnderline(underline)
.
Como os links não podem ser definidos em caracteres de nova linha, os caracteres de nova linha em TextRange
são ignorados.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(0);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slideIndex | Integer | O índice baseado em zero para o slide. |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Define um Link
para o Slide
especificado, o link é definido pelo ID do slide especificado.
Definir um link muda o estilo do texto a ser sublinhado e fica com a cor de primeiro plano ThemeColorType.HYPERLINK
. Isso pode ser alterado via setForegroundColor(hexColor)
e setUnderline(underline)
.
Como os links não podem ser definidos em caracteres de nova linha, os caracteres de nova linha em TextRange
são ignorados.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; text.getTextStyle().setLinkSlide(slide);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slide | Slide | O Slide a ser vinculado. |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Define um Link
para o Slide
especificado usando a posição relativa do slide.
Definir um link muda o estilo do texto a ser sublinhado e fica com a cor de primeiro plano ThemeColorType.HYPERLINK
. Isso pode ser alterado via setForegroundColor(hexColor)
e setUnderline(underline)
.
Como os links não podem ser definidos em caracteres de nova linha, os caracteres de nova linha em TextRange
são ignorados.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slidePosition | SlidePosition | O SlidePosition relativo. |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
Define um Link
para a string de URL não vazia fornecida.
Definir um link muda o estilo do texto a ser sublinhado e fica com a cor de primeiro plano ThemeColorType.HYPERLINK
. Isso pode ser alterado via setForegroundColor(hexColor)
e setUnderline(underline)
.
Como os links não podem ser definidos em caracteres de nova linha, os caracteres de nova linha em TextRange
são ignorados.
// Set a link to the URL. text.getTextStyle().setLinkUrl("https://slides.google.com");
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
url | String | A string do URL. |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setSmallCaps(smallCaps)
Define se o texto será renderizado em letras maiúsculas minúsculas.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
smallCaps | Boolean |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStrikethrough(strikethrough)
Define se o texto é riscado.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
strikethrough | Boolean |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setUnderline(underline)
Define se o texto será sublinhado.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
underline | Boolean |
Retornar
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations