Class TextStyle

TextStyle

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 TextRanges 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étodoTipo de retornoBreve descrição
getBackgroundColor()ColorRetorna a cor de fundo do texto ou null, se houver vários estilos no em textos.
getBaselineOffset()TextBaselineOffsetRetorna o deslocamento vertical do texto da posição normal ou null se houver vários estilos no texto.
getFontFamily()StringRetorna a família de fontes do texto ou null, se houver vários estilos no texto.
getFontSize()NumberRetorna o tamanho da fonte do texto em pontos ou null se houver vários estilos no o texto.
getFontWeight()IntegerRetorna a espessura da fonte do texto ou null, se houver vários estilos no texto.
getForegroundColor()ColorRetorna a cor do primeiro plano do texto ou null, se houver vários estilos no em textos.
getLink()LinkRetorna 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()BooleanRetorna 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()BooleanRetorna 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()BooleanRetorna true se o texto for renderizado como negrito, false se não for, ou null se há vários estilos no texto.
isItalic()BooleanRetorna true se o texto estiver em itálico, false se não estiver ou null se houver há vários estilos no texto.
isSmallCaps()BooleanRetorna 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()BooleanRetorna true se o texto estiver tachado, false se não tiver, ou null se estiver riscado há vários estilos no texto.
isUnderline()BooleanRetorna true se o texto estiver sublinhado, false se não estiver ou null se houver há vários estilos no texto.
removeLink()TextStyleRemove um Link.
setBackgroundColor(color)TextStyleDefine a cor de fundo do texto.
setBackgroundColor(red, green, blue)TextStyleDefine a cor de fundo do texto para os valores RGB fornecidos de 0 a 255.
setBackgroundColor(hexColor)TextStyleDefine a cor de fundo do texto como a string de cor hexadecimal especificada.
setBackgroundColor(color)TextStyleDefine a cor do plano de fundo do texto para o ThemeColorType especificado.
setBackgroundColorTransparent()TextStyleDefine a cor de fundo do texto como transparente.
setBaselineOffset(offset)TextStyleDefine o deslocamento vertical do texto em relação à posição normal.
setBold(bold)TextStyleDefine se o texto deve ser renderizado como negrito.
setFontFamily(fontFamily)TextStyleDefine a família de fontes do texto .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleDefine a família de fontes e a espessura do texto.
setFontSize(fontSize)TextStyleDefine o tamanho da fonte do texto, em pontos.
setForegroundColor(foregroundColor)TextStyleDefine a cor do primeiro plano do texto.
setForegroundColor(red, green, blue)TextStyleDefine a cor do primeiro plano do texto como os valores RGB fornecidos de 0 a 255.
setForegroundColor(hexColor)TextStyleDefine a cor do primeiro plano do texto como a string de cor hexadecimal especificada.
setForegroundColor(color)TextStyleDefine a cor do primeiro plano do texto para o ThemeColorType especificado.
setItalic(italic)TextStyleDefine se o texto ficará em itálico.
setLinkSlide(slideIndex)TextStyleDefine um Link para o Slide especificado usando o índice baseado em zero do slide.
setLinkSlide(slide)TextStyleDefine um Link para o Slide especificado, o link é definido pelo ID do slide especificado.
setLinkSlide(slidePosition)TextStyleDefine um Link para o Slide especificado usando a posição relativa do slide.
setLinkUrl(url)TextStyleDefine um Link para a string de URL não vazia fornecida.
setSmallCaps(smallCaps)TextStyleDefine se o texto será renderizado em letras maiúsculas minúsculas.
setStrikethrough(strikethrough)TextStyleDefine se o texto é riscado.
setUnderline(underline)TextStyleDefine 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

Color

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

TextBaselineOffset

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

Color

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

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

Link

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

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

Remove um Link.

A remoção de um link remove a cor de primeiro plano e o estilo de sublinhado do hiperlink do texto. Se possível, esses estilos são aplicados para corresponder ao texto que precede o link. 

text.getTextStyle().removeLink();

Retornar

TextStyle

setBackgroundColor(color)

Define a cor de fundo do texto.

Parâmetros

NomeTipoDescrição
colorColor

Retornar

TextStyle

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(red, green, blue)

Define a cor de fundo do texto para os valores RGB fornecidos de 0 a 255.

Parâmetros

NomeTipoDescrição
redInteger
greenInteger
blueInteger

Retornar

TextStyle

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

NomeTipoDescrição
hexColorString

Retornar

TextStyle

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

NomeTipoDescrição
colorThemeColorType

Retornar

TextStyle

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

Define a cor de fundo do texto como transparente.

Retornar

TextStyle

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

setBaselineOffset(offset)

Define o deslocamento vertical do texto em relação à posição normal.

Parâmetros

NomeTipoDescrição
offsetTextBaselineOffset

Retornar

TextStyle

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

NomeTipoDescrição
boldBoolean

Retornar

TextStyle

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

NomeTipoDescrição
fontFamilyString

Retornar

TextStyle

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

NomeTipoDescrição
fontFamilyString
fontWeightInteger

Retornar

TextStyle

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

NomeTipoDescrição
fontSizeNumber

Retornar

TextStyle

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

NomeTipoDescrição
foregroundColorColor

Retornar

TextStyle

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

NomeTipoDescrição
redInteger
greenInteger
blueInteger

Retornar

TextStyle

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

NomeTipoDescrição
hexColorString

Retornar

TextStyle

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

NomeTipoDescrição
colorThemeColorType

Retornar

TextStyle

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

NomeTipoDescrição
italicBoolean

Retornar

TextStyle

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

NomeTipoDescrição
slideIndexIntegerO índice baseado em zero para o slide.

Retornar

TextStyle

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

NomeTipoDescrição
slideSlideO Slide a ser vinculado.

Retornar

TextStyle

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

NomeTipoDescrição
slidePositionSlidePositionO SlidePosition relativo.

Retornar

TextStyle

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

NomeTipoDescrição
urlStringA string do URL.

Retornar

TextStyle

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

NomeTipoDescrição
smallCapsBoolean

Retornar

TextStyle

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

NomeTipoDescrição
strikethroughBoolean

Retornar

TextStyle

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

NomeTipoDescrição
underlineBoolean

Retornar

TextStyle

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