Esta página foi traduzida pela API Cloud Translation.

Class TextRange

Um segmento do conteúdo de texto de uma Shape ou TableCell.

Se você usar métodos que editam como o texto se encaixa em uma forma, todas as configurações de ajuste automático aplicadas à forma serão desativadas.

Métodos

Método	Tipo de retorno	Breve descrição
`appendParagraph(text)`	`Paragraph`	Anexar um parágrafo ao final do intervalo de texto.
`appendRange(textRange)`	`TextRange`	Anexa uma cópia do intervalo de texto fornecido ao final do intervalo de texto atual.
`appendRange(textRange, matchSourceFormatting)`	`TextRange`	Insere uma cópia do intervalo de texto fornecido no final do intervalo de texto atual.
`appendText(text)`	`TextRange`	Acrescenta texto ao final do intervalo de texto.
`asRenderedString()`	`String`	Retorna o texto renderizado delimitado por este intervalo da forma ou célula de tabela associada em um formato adequado para exibição aos usuários finais.
`asString()`	`String`	Retorna o texto bruto delimitado por este intervalo da forma ou célula de tabela associada.
`clear()`	`void`	Limpa o texto delimitado por esse intervalo.
`clear(startOffset, endOffset)`	`void`	Limpa o texto delimitado pelos deslocamentos inicial e final no intervalo.
`find(pattern)`	`TextRange[]`	Retorna todos os intervalos que correspondem ao padrão de pesquisa no intervalo de texto atual.
`find(pattern, startOffset)`	`TextRange[]`	Retorna todos os intervalos que correspondem ao padrão de pesquisa no intervalo de texto atual, a partir do deslocamento inicial.
`getAutoTexts()`	`AutoText[]`	Retorna os textos automáticos no intervalo de texto atual.
`getEndIndex()`	`Integer`	Retorna o índice exclusivo, baseado em 0, para o último caractere neste intervalo.
`getLength()`	`Integer`	Retorna o número de caracteres nesse intervalo.
`getLinks()`	`TextRange[]`	Retorna uma coleção de intervalos de texto que correspondem a todos os `Link`s no intervalo de texto atual ou que se sobrepõem a ele.
`getListParagraphs()`	`Paragraph[]`	Retorna os parágrafos em listas que se sobrepõem ao intervalo de texto atual.
`getListStyle()`	`ListStyle`	Retorna o `ListStyle` do intervalo de texto atual.
`getParagraphStyle()`	`ParagraphStyle`	Retorna o `ParagraphStyle` do intervalo de texto atual.
`getParagraphs()`	`Paragraph[]`	Retorna os parágrafos que se sobrepõem ao intervalo de texto atual.
`getRange(startOffset, endOffset)`	`TextRange`	Retorna um novo `TextRange` que abrange parte do intervalo de origem.
`getRuns()`	`TextRange[]`	Retorna as execuções de texto que se sobrepõem ao intervalo de texto atual.
`getStartIndex()`	`Integer`	Retorna o índice com base em 0 e inclusive para o primeiro caractere neste intervalo.
`getTextStyle()`	`TextStyle`	Retorna o estilo de texto do intervalo ou `null` se o intervalo estiver vazio.
`insertParagraph(startOffset, text)`	`Paragraph`	Insere um parágrafo no deslocamento inicial.
`insertRange(startOffset, textRange)`	`TextRange`	Insere uma cópia do intervalo de texto fornecido no deslocamento inicial.
`insertRange(startOffset, textRange, matchSourceFormatting)`	`TextRange`	Insere uma cópia do intervalo de texto fornecido no deslocamento inicial.
`insertText(startOffset, text)`	`TextRange`	Insere texto no deslocamento inicial.
`isEmpty()`	`Boolean`	Retorna `true` se não houver caracteres nesse intervalo e `false` caso contrário.
`replaceAllText(findText, replaceText)`	`Integer`	Substitui todas as instâncias de texto correspondentes ao texto de pesquisa por texto de substituição.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Substitui todas as instâncias de texto correspondentes ao texto de pesquisa por texto de substituição.
`select()`	`void`	Seleciona apenas o `TextRange` na apresentação ativa e remove qualquer seleção anterior.
`setText(newText)`	`TextRange`	Define o texto delimitado por esse intervalo da forma ou célula de tabela associada.

Documentação detalhada

`appendParagraph(text)`

Anexar um parágrafo ao final do intervalo de texto. O parágrafo mantém o estilo do final do intervalo de texto atual.

A string de texto fornecida é anexada como um parágrafo adicionando pelo menos um caractere de nova linha à string.

Quando a string de texto fornecida contém caracteres de nova linha (ou seja, consiste em vários parágrafos), o parágrafo final adicionado é retornado.

Parâmetros

Nome	Tipo	Descrição
`text`	`String`	A string a ser anexada como um parágrafo.

Retornar

Paragraph: o Paragraph anexado.

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

`appendRange(textRange)`

Insere uma cópia do intervalo de texto fornecido no final do intervalo de texto atual.

A formatação do texto inserido vai corresponder à do texto de origem.

Parâmetros

Nome	Tipo	Descrição
`textRange`	`TextRange`	O intervalo de texto a ser anexado.

Retornar

TextRange: o intervalo de texto que representa o texto anexado.

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

`appendRange(textRange, matchSourceFormatting)`

Anexa uma cópia do intervalo de texto fornecido ao final do intervalo de texto atual.

Se definido para corresponder à formatação do texto de destino, AutoText no intervalo de texto fornecido será substituído pelos valores renderizados. Além disso, elementos não textuais no intervalo de texto fornecido não são anexados.

Parâmetros

Nome	Tipo	Descrição
`textRange`	`TextRange`	O intervalo de texto a ser anexado.
`matchSourceFormatting`	`Boolean`	Se `true`, corresponde à formatação do texto de origem. Se `false`, corresponde à formatação do texto de destino.

Retornar

TextRange: o intervalo de texto que representa o texto anexado.

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

`appendText(text)`

Acrescenta texto ao final do intervalo de texto. O texto mantém o estilo do final do texto atual.

Parâmetros

Nome	Tipo	Descrição
`text`	`String`	A string a ser anexada.

Retornar

TextRange: o intervalo de texto que representa o texto anexado.

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

`asRenderedString()`

Retorna o texto renderizado delimitado por este intervalo da forma ou célula de tabela associada em um formato adequado para exibição aos usuários finais.

Os elementos de texto automático, como números de slides gerados, são substituídos pelos valores renderizados. Todos os elementos não textuais no intervalo são omitidos.

Retornar

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

`asString()`

Retorna o texto bruto delimitado por este intervalo da forma ou célula de tabela associada.

Os elementos de texto automático, como números de slides gerados e quaisquer elementos que não sejam de texto no intervalo, são substituídos pelo caractere Unicode U+E907.

Retornar

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

`clear()`

Limpa o texto delimitado por esse intervalo.

Como todo o texto em uma forma ou célula de tabela precisa terminar com uma nova linha, a nova linha final no texto não é removida.

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

`clear(startOffset, endOffset)`

Limpa o texto delimitado pelos deslocamentos inicial e final no intervalo.

Como o texto precisa terminar com uma nova linha, a nova linha final no texto não é removida, mesmo que seja coberta pelos deslocamentos fornecidos.

Parâmetros

Nome	Tipo	Descrição
`startOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice inicial inclusive do intervalo a ser limpo. O deslocamento inicial precisa ser igual ou maior que 0 e menor ou igual a `endOffset`. `startOffset` também precisa ser menor que o comprimento do intervalo atual.
`endOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice final exclusivo do intervalo a ser limpo. O `endOffset` precisa ser igual ou maior que `startOffset`. `endOffset` também precisa ser menor ou igual ao comprimento do intervalo atual.

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

`find(pattern)`

Retorna todos os intervalos que correspondem ao padrão de pesquisa no intervalo de texto atual. A pesquisa diferencia maiúsculas de minúsculas.

Parâmetros

Nome	Tipo	Descrição
`pattern`	`String`	O padrão de expressão regular a ser pesquisado. Todas as barras invertidas no padrão precisam ser escapadas.

Retornar

TextRange[]

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

`find(pattern, startOffset)`

Retorna todos os intervalos que correspondem ao padrão de pesquisa no intervalo de texto atual, a partir do deslocamento inicial. A pesquisa diferencia maiúsculas de minúsculas.

Parâmetros

Nome	Tipo	Descrição
`pattern`	`String`	O padrão de expressão regular a ser pesquisado. Todas as barras invertidas no padrão precisam ser escapadas.
`startOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice inicial inclusive do intervalo a ser pesquisado. `startOffset` também precisa ser menor que o comprimento do intervalo atual.

Retornar

TextRange[]

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

`getAutoTexts()`

Retorna os textos automáticos no intervalo de texto atual.

Retornar

AutoText[]

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

`getEndIndex()`

Retorna o índice exclusivo, baseado em 0, para o último caractere neste intervalo. Se os índices de início e fim forem iguais, o intervalo será considerado vazio.

Retornar

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

`getLength()`

Retorna o número de caracteres nesse intervalo.

Retornar

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

`getLinks()`

Retorna uma coleção de intervalos de texto que correspondem a todos os Links no intervalo de texto atual ou que se sobrepõem a ele.

Cada intervalo retornado tem garantia de abranger um link quando é criado. As modificações de texto podem fazer com que ele não represente mais exatamente um link.

Cada Link nos intervalos retornados pode ser acessado por TextStyle.getLink().

// Accesses the first link on a TextRange object.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
const linkTextRange = textRange.getLinks()[0];
const textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink());   // logs 'true'
const link = textStyle.getLink();  // Link object

Retornar

TextRange[]

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

`getListParagraphs()`

Retorna os parágrafos em listas que se sobrepõem ao intervalo de texto atual.

Retornar

Paragraph[]

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

`getListStyle()`

Retorna o ListStyle do intervalo de texto atual.

Retornar

ListStyle

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

`getParagraphStyle()`

Retorna o ParagraphStyle do intervalo de texto atual.

Retornar

ParagraphStyle

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

`getParagraphs()`

Retorna os parágrafos que se sobrepõem ao intervalo de texto atual.

Retornar

Paragraph[]

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

`getRange(startOffset, endOffset)`

Retorna um novo TextRange que abrange parte do intervalo de origem.

Parâmetros

Nome	Tipo	Descrição
`startOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice inicial inclusive do intervalo retornado. O deslocamento inicial precisa ser igual ou maior que 0 e menor ou igual a `endOffset`. `startOffset` também precisa ser menor que o comprimento do intervalo atual.
`endOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice final exclusivo do intervalo retornado. O `endOffset` precisa ser igual ou maior que `startOffset`. `endOffset` também precisa ser menor ou igual ao comprimento do intervalo atual.

Retornar

TextRange

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

`getRuns()`

Retorna as execuções de texto que se sobrepõem ao intervalo de texto atual. Uma execução de texto é um segmento de texto em que todos os caracteres têm o mesmo estilo de texto.

Cada intervalo retornado só tem garantia de abranger uma execução quando é criado. Modificações de texto ou estilo podem fazer com que ele não represente mais exatamente uma execução.

Retornar

TextRange[]

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

`getStartIndex()`

Retorna o índice com base em 0 e inclusive para o primeiro caractere neste intervalo. Se os índices inicial e final forem iguais, o intervalo será considerado vazio.

Retornar

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

`getTextStyle()`

Retorna o estilo de texto do intervalo ou null se o intervalo estiver vazio.

Retornar

TextStyle

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

`insertParagraph(startOffset, text)`

Insere um parágrafo no deslocamento inicial. O parágrafo mantém o estilo do intervalo de texto atual no deslocamento inicial.

A string de texto fornecida é inserida como um parágrafo adicionando pelo menos um caractere de nova linha à string.

Quando a string de texto fornecida contém caracteres de nova linha (ou seja, consiste em vários parágrafos), o parágrafo final adicionado é retornado.

Parâmetros

Nome	Tipo	Descrição
`startOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice inicial inclusive do texto a ser inserido.
`text`	`String`	A string a ser inserida.

Retornar

Paragraph: o Paragraph inserido.

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

`insertRange(startOffset, textRange)`

Insere uma cópia do intervalo de texto fornecido no deslocamento inicial.

A formatação do texto inserido vai corresponder à do texto de origem.

Parâmetros

Nome	Tipo	Descrição
`startOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice inicial inclusive do texto a ser inserido.
`textRange`	`TextRange`	O intervalo de texto a ser inserido.

Retornar

TextRange: o intervalo de texto que representa o texto inserido.

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

`insertRange(startOffset, textRange, matchSourceFormatting)`

Insere uma cópia do intervalo de texto fornecido no deslocamento inicial.

Se definido para corresponder à formatação do texto de destino, AutoText no intervalo de texto fornecido será substituído pelos valores renderizados. Além disso, elementos não textuais dentro do intervalo de texto fornecido não são inseridos.

Parâmetros

Nome	Tipo	Descrição
`startOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice inicial inclusive do texto a ser inserido.
`textRange`	`TextRange`	O intervalo de texto a ser inserido.
`matchSourceFormatting`	`Boolean`	Se `true`, corresponde à formatação do texto de origem. Se `false`, corresponde à formatação do texto de destino.

Retornar

TextRange: o intervalo de texto que representa o texto inserido.

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

`insertText(startOffset, text)`

Insere texto no deslocamento inicial. O texto mantém o estilo do texto existente no deslocamento inicial.

Parâmetros

Nome	Tipo	Descrição
`startOffset`	`Integer`	O número de caracteres após o índice inicial do intervalo de texto atual usado para determinar o índice inicial inclusive do texto a ser inserido.
`text`	`String`	A string a ser inserida.

Retornar

TextRange: o intervalo de texto que representa o texto inserido.

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

`isEmpty()`

Retorna true se não houver caracteres nesse intervalo e false caso contrário.

Retornar

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

`replaceAllText(findText, replaceText)`

Substitui todas as instâncias de texto correspondentes ao texto de pesquisa por texto de substituição. A pesquisa não diferencia maiúsculas de minúsculas.

Parâmetros

Nome	Tipo	Descrição
`findText`	`String`	O texto a ser encontrado.
`replaceText`	`String`	O texto que vai substituir o texto correspondente.

Retornar

Integer: o número de ocorrências alteradas

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

`replaceAllText(findText, replaceText, matchCase)`

Substitui todas as instâncias de texto correspondentes ao texto de pesquisa por texto de substituição.

Parâmetros

Nome	Tipo	Descrição
`findText`	`String`	O texto a ser encontrado.
`replaceText`	`String`	O texto que vai substituir o texto correspondente.
`matchCase`	`Boolean`	Se `true`, a pesquisa diferencia maiúsculas de minúsculas. Se `false`, a pesquisa não diferencia maiúsculas de minúsculas.

Retornar

Integer: o número de ocorrências alteradas

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

`select()`

Seleciona apenas o TextRange na apresentação ativa e remove qualquer seleção anterior.

Um script só pode acessar a seleção do usuário que está executando o script e somente se ele estiver vinculado à apresentação.

O Page pai do Shape correspondente ou do TableCell é definido como current page selection. O Shape ou o TableCell é definido como selected page element.

O Selection pode ser de dois tipos:

1. Intervalo de texto: use a seleção em um TextRange não vazio para selecionar o intervalo dos caracteres.

2. Posição do cursor: use um TextRange vazio para colocar o cursor no índice desejado.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.getText().setText('Hello');
// Range selection: Select the text range "He".
shape.getText().getRange(0, 2).select();
// Cursor selection: Place the cursor after "H" like "H|ello".
shape.getText().getRange(1, 1).select();

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

`setText(newText)`

Define o texto delimitado por esse intervalo da forma ou célula de tabela associada. O texto mantém o estilo do início do texto existente.

Parâmetros

Nome	Tipo	Descrição
`newText`	`String`	A string a ser definida como o novo texto.

Retornar

TextRange: o intervalo de texto que representa o texto definido

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