Encontrar ou substituir texto em um intervalo, uma página ou uma planilha. Também é possível especificar opções de pesquisa.
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
find | Range[] | Retorna todas as células que correspondem aos critérios de pesquisa. |
find | Range | Retorna a próxima célula que corresponde aos critérios de pesquisa. |
find | Range | Retorna a célula anterior que corresponde aos critérios de pesquisa. |
get | Range | Retorna a célula atual que corresponde aos critérios de pesquisa. |
ignore | Text | Se true, a pesquisa será configurada para ignorar acentos ao fazer a correspondência. Caso contrário, a pesquisa vai corresponder a acentos. |
match | Text | Se true, configura a pesquisa para corresponder exatamente ao uso de maiúsculas e minúsculas do texto de pesquisa. Caso contrário, a pesquisa usa a correspondência sem diferenciação de maiúsculas e minúsculas por padrão. |
match | Text | Se true, configura a pesquisa para corresponder a todo o conteúdo de uma célula. Caso contrário, a pesquisa usa a correspondência parcial por padrão. |
match | Text | Se true, configura a pesquisa para retornar correspondências que aparecem no texto da fórmula. Caso contrário, as células com fórmulas são consideradas com base no valor mostrado. |
replace | Integer | Substitui todas as correspondências pelo texto especificado. |
replace | Integer | Substitui o texto de pesquisa na célula correspondente atual pelo texto especificado e retorna o número de ocorrências substituídas. |
start | Text | Configura a pesquisa para começar imediatamente após o intervalo de células especificado. |
use | Text | Se true, configura a pesquisa para interpretar a string de pesquisa como uma expressão regular. Caso contrário, a pesquisa interpreta a string de pesquisa como texto normal. |
Documentação detalhada
findAll()
Retorna todas as células que correspondem aos critérios de pesquisa.
Retornar
Range[]: todas as células correspondentes.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findNext()
Retorna a próxima célula que corresponde aos critérios de pesquisa.
Retornar
Range: a próxima célula correspondente ou null se não houver correspondências anteriores.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findPrevious()
Retorna a célula anterior que corresponde aos critérios de pesquisa.
Retornar
Range: a célula correspondente anterior ou null se não houver correspondências anteriores.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCurrentMatch()
Retorna a célula atual que corresponde aos critérios de pesquisa.
Retornar
Range: a célula correspondente atual ou null se não houver mais correspondências.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
ignoreDiacritics(ignoreDiacritics)
Se true, a pesquisa será configurada para ignorar acentos ao fazer a correspondência. Caso contrário, a pesquisa vai corresponder a acentos. Um diacrítico é um sinal, como um acento ou uma cedilha, que, quando escrito acima ou abaixo de uma letra, indica uma diferença na pronúncia da mesma letra quando não marcada ou marcada de forma diferente.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
ignore | Boolean | Se a pesquisa considera acentos. |
Retornar
TextFinder: este localizador de texto, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
Se true, configura a pesquisa para corresponder exatamente ao uso de maiúsculas e minúsculas do texto de pesquisa. Caso contrário, a pesquisa usa a correspondência sem diferenciação de maiúsculas e minúsculas por padrão.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
match | Boolean | Se a correspondência diferencia maiúsculas de minúsculas. |
Retornar
TextFinder: este localizador de texto, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
Se true, configura a pesquisa para corresponder a todo o conteúdo de uma célula. Caso contrário, a pesquisa usa a correspondência parcial por padrão.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
match | Boolean | Se toda a célula corresponde. |
Retornar
TextFinder: este localizador de texto, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
Se true, configura a pesquisa para retornar correspondências que aparecem no texto da fórmula. Caso contrário, as células com fórmulas são consideradas com base no valor mostrado.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
match | Boolean | Se a pesquisa examina o texto da fórmula. |
Retornar
TextFinder: este localizador de texto, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
Substitui todas as correspondências pelo texto especificado. Retorna o número de ocorrências substituídas, que pode ser diferente do número de células correspondentes.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
replace | String | O texto que substitui o texto nas células correspondentes. |
Retornar
Integer: o número de ocorrências substituídas.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
Substitui o texto de pesquisa na célula correspondente atual pelo texto especificado e retorna o número de ocorrências substituídas.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
replace | String | O texto que substitui o conteúdo na célula correspondente. |
Retornar
Integer: o número de ocorrências substituídas.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
Configura a pesquisa para começar imediatamente após o intervalo de células especificado.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
start | Range | O intervalo de células após o qual a pesquisa deve começar. |
Retornar
TextFinder: este localizador de texto, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
Se true, configura a pesquisa para interpretar a string de pesquisa como uma expressão regular. Caso contrário, a pesquisa interpreta a string de pesquisa como texto normal. Para mais detalhes sobre como
usar expressões regulares, consulte a
página de suporte "Encontrar e substituir".
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
use | Boolean | Se a string de pesquisa deve ser interpretada como uma expressão regular. |
Retornar
TextFinder: este localizador de texto, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets