Class TextFinder

TextFinder

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é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 signos diacríticos durante la coincidencia; de lo contrario, la búsqueda coincide con los signos diacríticos.
matchCase(matchCase)TextFinderSi 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)TextFinderSi 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)TextFinderSi 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)IntegerReemplaza todas las coincidencias con el texto especificado.
replaceWith(replaceText)IntegerReemplaza el texto de búsqueda en la celda que coincide actualmente con el texto especificado y muestra la cantidad de casos reemplazados.
startFrom(startRange)TextFinderConfigura la búsqueda para que comience inmediatamente después del rango de celdas especificado.
useRegularExpression(useRegEx)TextFinderSi 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

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

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

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

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

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

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

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

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