Busca o reemplaza texto dentro de un rango, hoja de cálculo o hoja de cálculo. También puede 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 diacríticos mientras coincide; de lo contrario, la búsqueda coincidirá con los diacríticos. |
matchCase(matchCase) | TextFinder | Si es true, configura la búsqueda para que coincida exactamente con el texto de búsqueda; de lo contrario, la búsqueda se establece de forma predeterminada con coincidencias que no distinguen entre mayúsculas y 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 se establece de forma predeterminada con una coincidencia parcial. |
matchFormulaText(matchFormulaText) | TextFinder | Si es true, configura la búsqueda para mostrar coincidencias que aparezcan dentro del texto de fórmula. De lo contrario, las celdas con fórmulas se consideran según su valor mostrado. |
replaceAllWith(replaceText) | Integer | Reemplaza todas las coincidencias con el texto especificado. |
replaceWith(replaceText) | Integer | Reemplaza el texto de búsqueda de la celda coincidente actual con el texto especificado y muestra la cantidad de casos reemplazados. |
startFrom(startRange) | TextFinder | Configura la búsqueda para que comience a buscarse inmediatamente después del rango de celdas especificado. |
useRegularExpression(useRegEx) | TextFinder | Si es true, configura la búsqueda para que interprete la string de búsqueda como una expresión regular; de lo contrario, la búsqueda interpretará la string de búsqueda como texto normal. |
Documentación detallada
findAll()
Muestra todas las celdas que coinciden con los criterios de búsqueda.
Volver
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.
Volver
Range: Es la próxima celda que coincida 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.
Volver
Range: Es la celda que coincidió anteriormente 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.
Volver
Range: Es la celda que coincide en este momento 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 diacríticos mientras coincide; de lo contrario, la búsqueda coincidirá con los 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 se la marca de manera diferente o no.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
ignoreDiacritics | Boolean | Si la búsqueda considera diacríticos. |
Volver
TextFinder: este buscador de texto 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 el texto de búsqueda; de lo contrario, la búsqueda se establece de forma predeterminada con coincidencias que no distinguen entre mayúsculas y minúsculas.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
matchCase | Boolean | Si la coincidencia distingue entre mayúsculas y minúsculas |
Volver
TextFinder: este buscador de texto 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 se establece de forma predeterminada con una coincidencia parcial.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
matchEntireCell | Boolean | Si toda la celda coincide. |
Volver
TextFinder: este buscador de texto 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 mostrar coincidencias que aparezcan dentro del texto de fórmula. De lo contrario, las celdas con fórmulas se consideran según su valor mostrado.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
matchFormulaText | Boolean | Indica si la búsqueda examina el texto de la fórmula. |
Volver
TextFinder: este buscador de texto 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 de la cantidad de celdas coincidentes.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
replaceText | String | El texto que reemplaza al texto en las celdas coincidentes. |
Volver
Integer: 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 de la celda coincidente actual 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. |
Volver
Integer: 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 a buscarse inmediatamente después del rango de celdas especificado.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
startRange | Range | El rango de celdas después del cual debe comenzar la búsqueda. |
Volver
TextFinder: este buscador de texto 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 que interprete la string de búsqueda como una expresión regular; de lo contrario, la búsqueda interpretará la string de búsqueda como texto normal. Para obtener más detalles sobre cómo usar expresiones regulares, consulta la página de asistencia sobre cómo buscar y reemplazar.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
useRegEx | Boolean | Indica si se debe interpretar la string de búsqueda como una expresión regular. |
Volver
TextFinder: este buscador de texto 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