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