Class TextFinder

TextFinder

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étodoTipo de datos que se muestraDescripción breve
findAll()Range[]Muestra todas las celdas que coinciden con los criterios de búsqueda.
findNext()RangeMuestra la siguiente celda que coincide con los criterios de búsqueda.
findPrevious()RangeMuestra la celda anterior que coincide con los criterios de búsqueda.
getCurrentMatch()RangeMuestra la celda actual que coincide con los criterios de búsqueda.
ignoreDiacritics(ignoreDiacritics)TextFinderSi 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)TextFinderSi 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)TextFinderSi 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)TextFinderSi 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)IntegerReemplaza todas las coincidencias con el texto especificado.
replaceWith(replaceText)IntegerReemplaza el texto de búsqueda de la celda coincidente actual con el texto especificado y muestra la cantidad de casos reemplazados.
startFrom(startRange)TextFinderConfigura la búsqueda para que comience a buscarse inmediatamente después del rango de celdas especificado.
useRegularExpression(useRegEx)TextFinderSi 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

NombreTipoDescripción
ignoreDiacriticsBooleanSi 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

NombreTipoDescripción
matchCaseBooleanSi 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

NombreTipoDescripción
matchEntireCellBooleanSi 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

NombreTipoDescripción
matchFormulaTextBooleanIndica 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

NombreTipoDescripción
replaceTextStringEl 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

NombreTipoDescripción
replaceTextStringEl 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

NombreTipoDescripción
startRangeRangeEl 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

NombreTipoDescripción
useRegExBooleanIndica 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