O estilo do texto.
Os métodos de leitura nessa classe vão retornar null
se o TextRange
correspondente abranger
várias execuções de texto e essas execuções tiverem valores diferentes para o método de leitura que estiver sendo chamado. 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, todas as configurações de ajuste automático aplicadas aos estilos de texto serão desativadas.
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
texto. |
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 texto. |
getFontWeight() | Integer | Retorna a espessura da fonte do texto ou null se houver vários estilos no texto. |
getForegroundColor() | Color | Retorna a cor de primeiro plano do texto ou null se houver vários estilos no
texto. |
getLink() | Link | Retorna o Link no texto ou null se não houver link ou se o link estiver em
parte do texto ou se houver vários links. |
hasLink() | Boolean | Retorna true se houver link no texto, false se não houver ou null se o
link fizer parte do texto ou houver 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 é renderizado como negrito, false se não for, ou null se
houver 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
vários estilos no texto. |
isSmallCaps() | Boolean | Retorna true se o texto estiver em letras maiúsculas pequenas, false se não estiver ou null se houver vários estilos no texto. |
isStrikethrough() | Boolean | Retorna true se o texto é tachado, false se não for ou null se
houver vários estilos no texto. |
isUnderline() | Boolean | Retorna true se o texto estiver sublinhado, false se não estiver ou null se houver
vários estilos no texto. |
removeLink() | TextStyle | Remove um Link . |
setBackgroundColor(color) | TextStyle | Define a cor do plano de fundo do texto. |
setBackgroundColor(red, green, blue) | TextStyle | Define a cor de plano de fundo do texto para os valores RGB fornecidos de 0 a 255. |
setBackgroundColor(hexColor) | TextStyle | Define a cor do plano de fundo do texto para 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 precisa ser renderizado em 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 para os valores RGB fornecidos de 0 a 255. |
setForegroundColor(hexColor) | TextStyle | Define a cor do primeiro plano do texto para 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 será exibido 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 fornecido. |
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 pequenas. |
setStrikethrough(strikethrough) | TextStyle | Define se o texto será tachado. |
setUnderline(underline) | TextStyle | Define se o texto será sublinhado. |
Documentação detalhada
getBackgroundColor()
getBaselineOffset()
Retorna o deslocamento vertical do texto da posição normal ou null
se houver
vários estilos no texto.
Retorno
Autorização
Os scripts que usam esse método exigem 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.
Retorno
String
Autorização
Os scripts que usam esse método exigem 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 texto.
Retorno
Number
Autorização
Os scripts que usam esse método exigem 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 aos valores numéricos descritos na especificação do 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,
nesse caso, isBold()
retorna true
. O valor padrão é 400 ("normal").
Retorno
Integer
Autorização
Os scripts que usam esse método exigem 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 de primeiro plano do texto ou null
se houver vários estilos no
texto.
Retorno
Autorização
Os scripts que usam esse método exigem 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 link ou se o link estiver em
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()); }
Retorno
Autorização
Os scripts que usam esse método exigem 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 link no texto, false
se não houver ou null
se o
link fizer parte do texto ou houver vários links.
Não é possível definir links em caracteres de nova linha. Portanto, se TextRange
contiver um
caractere de nova linha, esse método sempre retornará null
ou false
.
Retorno
Boolean
Autorização
Os scripts que usam esse método exigem 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.
Retorno
Boolean
Autorização
Os scripts que usam esse método exigem 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 é renderizado como negrito, false
se não for, ou null
se
houver vários estilos no texto.
Retorno
Boolean
Autorização
Os scripts que usam esse método exigem 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
vários estilos no texto.
Retorno
Boolean
Autorização
Os scripts que usam esse método exigem 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 pequenas, false
se não estiver ou null
se houver vários estilos no texto.
Retorno
Boolean
Autorização
Os scripts que usam esse método exigem 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 é tachado, false
se não for ou null
se
houver vários estilos no texto.
Retorno
Boolean
Autorização
Os scripts que usam esse método exigem 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
vários estilos no texto.
Retorno
Boolean
Autorização
Os scripts que usam esse método exigem 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 plano 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 do plano de fundo do texto para 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 precisa ser renderizado em negrito.
Mudar o negrito do texto atualiza a espessura da fonte usada para renderizar o texto.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
bold | Boolean |
Retorno
Autorização
Os scripts que usam esse método exigem 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 aos valores numéricos descritos na especificação do 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,
nesse caso, isBold()
retorna true
. O valor padrão é 400 ("normal").
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
Retorno
Autorização
Os scripts que usam esse método exigem 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 para os valores RGB fornecidos de 0 a 255.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Retorno
Autorização
Os scripts que usam esse método exigem 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 para 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 |
Retorno
Autorização
Os scripts que usam esse método exigem 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 será exibido em itálico.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
italic | Boolean |
Retorno
Autorização
Os scripts que usam esse método exigem 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.
A definição de um link muda o estilo do texto para ser sublinhado e para ter uma cor de primeiro plano ThemeColorType.HYPERLINK
. Isso pode ser mudado usando setForegroundColor(hexColor)
e setUnderline(underline)
.
Como os links não podem ser definidos em caracteres de nova linha, esses caracteres 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. |
Retorno
Autorização
Os scripts que usam esse método exigem 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 fornecido.
A definição de um link muda o estilo do texto para ser sublinhado e para ter uma cor de primeiro plano ThemeColorType.HYPERLINK
. Isso pode ser mudado usando setForegroundColor(hexColor)
e setUnderline(underline)
.
Como os links não podem ser definidos em caracteres de nova linha, esses caracteres 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 que será vinculado. |
Retorno
Autorização
Os scripts que usam esse método exigem 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.
A definição de um link muda o estilo do texto para ser sublinhado e para ter uma cor de primeiro plano ThemeColorType.HYPERLINK
. Isso pode ser mudado usando setForegroundColor(hexColor)
e setUnderline(underline)
.
Como os links não podem ser definidos em caracteres de nova linha, esses caracteres 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. |
Retorno
Autorização
Os scripts que usam esse método exigem 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.
A definição de um link muda o estilo do texto para ser sublinhado e para ter uma cor de primeiro plano ThemeColorType.HYPERLINK
. Isso pode ser mudado usando setForegroundColor(hexColor)
e setUnderline(underline)
.
Como os links não podem ser definidos em caracteres de nova linha, esses caracteres 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. |
Retorno
Autorização
Os scripts que usam esse método exigem 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 pequenas.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
smallCaps | Boolean |
Retorno
Autorização
Os scripts que usam esse método exigem 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 será tachado.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
strikethrough | Boolean |
Retorno
Autorização
Os scripts que usam esse método exigem 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 |
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations