Busca o reemplaza texto en un rango, una hoja o una hoja de cálculo. También se pueden especificar opciones de búsqueda.
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
findAll() | Range[] | Muestra todas las celdas que coinciden con los criterios de búsqueda. |
findNext() | Range | Muestra la siguiente celda que coincide con los criterios de búsqueda. |
findPrevious() | Range | Muestra la celda anterior que coincide con los criterios de búsqueda. |
getCurrentMatch() | Range | Muestra la celda actual que coincide con los criterios de búsqueda. |
ignoreDiacritics(ignoreDiacritics) | TextFinder | Si es true, configura la búsqueda para que ignore los signos diacríticos durante la coincidencia; de lo contrario, la búsqueda coincide con los signos diacríticos. |
matchCase(matchCase) | TextFinder | Si es true, configura la búsqueda para que coincida exactamente con las mayúsculas y minúsculas del texto de búsqueda; de lo contrario, la búsqueda usará la coincidencia que no distingue mayúsculas de minúsculas. |
matchEntireCell(matchEntireCell) | TextFinder | Si es true, configura la búsqueda para que coincida con todo el contenido de una celda; de lo contrario, la búsqueda tendrá una coincidencia parcial de forma predeterminada. |
matchFormulaText(matchFormulaText) | TextFinder | Si es true, configura la búsqueda para que muestre las coincidencias que aparecen en el texto de la fórmula. De lo contrario, las celdas con fórmulas se consideran según el valor que se muestre. |
replaceAllWith(replaceText) | Integer | Reemplaza todas las coincidencias con el texto especificado. |
replaceWith(replaceText) | Integer | Reemplaza el texto de búsqueda en la celda que coincide actualmente con el texto especificado y muestra la cantidad de casos reemplazados. |
startFrom(startRange) | TextFinder | Configura la búsqueda para que comience inmediatamente después del rango de celdas especificado. |
useRegularExpression(useRegEx) | TextFinder | Si es true, configura la búsqueda para interpretar la string de búsqueda como una expresión regular; de lo contrario, la búsqueda interpretará la string como texto normal. |
Documentación detallada
findAll()
Muestra todas las celdas que coinciden con los criterios de búsqueda.
Devolvedor
Range[]: Todas las celdas coincidentes.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findNext()
Muestra la siguiente celda que coincide con los criterios de búsqueda.
Devolvedor
Range: Es la siguiente celda que coincide o null si no hay coincidencias anteriores.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findPrevious()
Muestra la celda anterior que coincide con los criterios de búsqueda.
Devolvedor
Range: Es la celda anterior que coincide o null si no hay coincidencias anteriores.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCurrentMatch()
Muestra la celda actual que coincide con los criterios de búsqueda.
Devolvedor
Range: Es la celda actual que coincide o null si no hay más coincidencias.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
ignoreDiacritics(ignoreDiacritics)
Si es true, configura la búsqueda para que ignore los signos diacríticos durante la coincidencia; de lo contrario, la búsqueda coincide con los signos diacríticos. Un diacrítico es un signo, como un acento o una cedilla, que cuando se escribe arriba o debajo de una letra, indica una diferencia en la pronunciación con respecto a la misma letra cuando no está marcada o se marca de forma diferente.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
ignoreDiacritics | Boolean | Indica si la búsqueda considera diacríticos. |
Devolvedor
TextFinder: Este buscador de texto se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
Si es true, configura la búsqueda para que coincida exactamente con las mayúsculas y minúsculas del texto de búsqueda; de lo contrario, la búsqueda usará la coincidencia que no distingue mayúsculas de minúsculas.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
matchCase | Boolean | Si la coincidencia distingue mayúsculas de minúsculas |
Devolvedor
TextFinder: Este buscador de texto se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
Si es true, configura la búsqueda para que coincida con todo el contenido de una celda; de lo contrario, la búsqueda tendrá una coincidencia parcial de forma predeterminada.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
matchEntireCell | Boolean | Indica si se establece una coincidencia con toda la celda. |
Devolvedor
TextFinder: Este buscador de texto se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
Si es true, configura la búsqueda para que muestre las coincidencias que aparecen en el texto de la fórmula. De lo contrario, las celdas con fórmulas se consideran según el valor que se muestre.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
matchFormulaText | Boolean | Si la búsqueda examina el texto de la fórmula. |
Devolvedor
TextFinder: Este buscador de texto se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
Reemplaza todas las coincidencias con el texto especificado. Muestra la cantidad de casos reemplazados, que puede ser diferente del número de celdas coincidentes.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
replaceText | String | El texto que reemplaza al texto en las celdas coincidentes. |
Devolvedor
Integer: Es la cantidad de casos reemplazados.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
Reemplaza el texto de búsqueda en la celda que coincide actualmente con el texto especificado y muestra la cantidad de casos reemplazados.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
replaceText | String | El texto que reemplaza el contenido en la celda que coincide actualmente. |
Devolvedor
Integer: Es la cantidad de casos reemplazados.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
Configura la búsqueda para que comience inmediatamente después del rango de celdas especificado.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
startRange | Range | Rango de celdas después del cual debe comenzar la búsqueda. |
Devolvedor
TextFinder: Este buscador de texto se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
Si es true, configura la búsqueda para interpretar la string de búsqueda como una expresión regular; de lo contrario, la búsqueda interpretará la string como texto normal. Para obtener más detalles sobre cómo usar expresiones regulares, consulta la
página para buscar y reemplazar compatibilidad.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
useRegEx | Boolean | Indica si se debe interpretar la string de búsqueda como una expresión regular. |
Devolvedor
TextFinder: Este buscador de texto se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets