Se usó la API de Cloud Translation para traducir esta página.

Class TextFinder

Buscar o reemplazar texto dentro de un rango, una hoja o una hoja de cálculo También puedes especificar opciones de búsqueda.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`findAll()`	`Range[]`	Devuelve todas las celdas que coincidan 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 se configura como `true`, la búsqueda coincide exactamente con el caso del texto de búsqueda. De lo contrario, la búsqueda se establece de forma predeterminada en 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 se establece de forma predeterminada en la coincidencia parcial.
`matchFormulaText(matchFormulaText)`	`TextFinder`	Si es `true`, configura la búsqueda para que muestre coincidencias que aparezcan dentro del texto de la fórmula. De lo contrario, las celdas con fórmulas se consideran según su valor mostrado.
`replaceAllWith(replaceText)`	`Integer`	Reemplaza todas las coincidencias por 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 ocurrencias reemplazadas.
`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 que interprete la cadena de búsqueda como una expresión regular. De lo contrario, la búsqueda interpreta la cadena de búsqueda como texto normal.

Documentación detallada

`findAll()`

Devuelve todas las celdas que coincidan con los criterios de búsqueda.

Volver

Range[]: Todas las celdas que coinciden.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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 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 ámbitos:

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 coincidente anterior 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 ámbitos:

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 coincidente actual 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 ámbitos:

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 sobre o debajo de una letra, indica una diferencia en la pronunciación de la misma letra cuando no está marcada o está marcada de manera diferente.

Parámetros

Nombre	Tipo	Descripción
`ignoreDiacritics`	`Boolean`	Indica si la búsqueda considera los diacríticos.

Volver

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 ámbitos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`matchCase(matchCase)`

Si se configura como true, la búsqueda coincide exactamente con el caso del texto de búsqueda. De lo contrario, la búsqueda se establece de forma predeterminada en la coincidencia que no distingue mayúsculas de minúsculas.

Parámetros

Nombre	Tipo	Descripción
`matchCase`	`Boolean`	Indica si la coincidencia distingue mayúsculas de minúsculas.

Volver

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 ámbitos:

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 en la coincidencia parcial.

Parámetros

Nombre	Tipo	Descripción
`matchEntireCell`	`Boolean`	Indica si toda la celda coincide.

Volver

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 ámbitos:

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 coincidencias que aparezcan dentro del texto de la 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 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 ámbitos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`replaceAllWith(replaceText)`

Reemplaza todas las coincidencias por el texto especificado. Muestra la cantidad de ocurrencias reemplazadas, que puede ser diferente de la cantidad de celdas que coinciden.

Parámetros

Nombre	Tipo	Descripción
`replaceText`	`String`	Es el texto que reemplaza el texto de las celdas que coinciden.

Volver

Integer: Es la cantidad de ocurrencias reemplazadas.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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 ocurrencias reemplazadas.

Parámetros

Nombre	Tipo	Descripción
`replaceText`	`String`	Es el texto que reemplaza el contenido de la celda que coincide actualmente.

Volver

Integer: Es la cantidad de ocurrencias reemplazadas.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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`	Es el rango de celdas después del cual debe comenzar la búsqueda.

Volver

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 ámbitos:

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 cadena de búsqueda como una expresión regular. De lo contrario, la búsqueda interpreta la cadena de búsqueda como texto normal. Para obtener más detalles sobre cómo usar expresiones regulares, consulta la página de asistencia de Buscar y reemplazar.

Parámetros

Nombre	Tipo	Descripción
`useRegEx`	`Boolean`	Indica si se debe interpretar la cadena de búsqueda como una expresión regular.

Volver

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 ámbitos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets