Class TextFinder

TextFinder

Rechercher ou remplacer du texte dans une plage de cellules, une feuille ou une feuille de calcul Vous pouvez également spécifier des options de recherche.

Méthodes

MéthodeType renvoyéBrève description
findAll()Range[]Affiche toutes les cellules correspondant aux critères de recherche.
findNext()RangeAffiche la cellule suivante correspondant aux critères de recherche.
findPrevious()RangeRenvoie la cellule précédente correspondant aux critères de recherche.
getCurrentMatch()RangeRenvoie la cellule actuellement sélectionnée correspondant aux critères de recherche.
ignoreDiacritics(ignoreDiacritics)TextFinderSi la valeur est true, configure la recherche de façon à ignorer les diacritiques lors de la mise en correspondance. Sinon, la recherche correspond aux diacritiques.
matchCase(matchCase)TextFinderSi la valeur est true, configure la recherche pour qu'elle corresponde exactement à la casse du texte recherché. Sinon, la recherche utilise par défaut la correspondance non sensible à la casse.
matchEntireCell(matchEntireCell)TextFinderSi la valeur est true, configure la recherche pour qu'elle corresponde à l'intégralité du contenu d'une cellule. Sinon, la recherche est définie par défaut sur une correspondance partielle.
matchFormulaText(matchFormulaText)TextFinderSi la valeur est true, configure la recherche pour renvoyer les correspondances qui apparaissent dans le texte de la formule. Sinon, les cellules contenant des formules sont prises en compte en fonction de leur valeur affichée.
replaceAllWith(replaceText)IntegerRemplace toutes les correspondances par le texte spécifié.
replaceWith(replaceText)IntegerRemplace le texte de recherche dans la cellule actuellement correspondante par le texte spécifié et renvoie le nombre d'occurrences remplacées.
startFrom(startRange)TextFinderConfigure la recherche pour qu'elle commence immédiatement après la plage de cellules spécifiée.
useRegularExpression(useRegEx)TextFinderSi la valeur est true, configure la recherche pour interpréter la chaîne de recherche comme une expression régulière. Sinon, la recherche interprète la chaîne de recherche comme un texte normal.

Documentation détaillée

findAll()

Affiche toutes les cellules correspondant aux critères de recherche.

Renvois

Range[] : toutes les cellules correspondantes.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

findNext()

Affiche la cellule suivante correspondant aux critères de recherche.

Renvois

Range : cellule correspondante suivante ou null en l'absence de correspondance précédente.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

findPrevious()

Renvoie la cellule précédente correspondant aux critères de recherche.

Renvois

Range : cellule correspondante précédente ou null en l'absence de correspondance précédente.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

getCurrentMatch()

Renvoie la cellule actuellement sélectionnée correspondant aux critères de recherche.

Renvois

Range : cellule correspondante actuelle ou null s'il n'y a pas d'autres correspondances.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

ignoreDiacritics(ignoreDiacritics)

Si la valeur est true, configure la recherche de façon à ignorer les diacritiques lors de la mise en correspondance. Sinon, la recherche correspond aux diacritiques. Un diacritique est un signe, tel qu'un accent ou une cédille, qui, lorsqu'il est écrit au-dessus ou en dessous d'une lettre, indique une différence de prononciation par rapport à la même lettre lorsqu'il n'est pas marqué ou qu'il est marqué différemment.

Paramètres

NomTypeDescription
ignoreDiacriticsBooleanIndique si la recherche prend en compte les diacritiques.

Renvois

TextFinder : cet outil de recherche de texte, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

matchCase(matchCase)

Si la valeur est true, configure la recherche pour qu'elle corresponde exactement à la casse du texte recherché. Sinon, la recherche utilise par défaut la correspondance non sensible à la casse.

Paramètres

NomTypeDescription
matchCaseBooleanIndique si la correspondance est sensible à la casse.

Renvois

TextFinder : cet outil de recherche de texte, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

matchEntireCell(matchEntireCell)

Si la valeur est true, configure la recherche pour qu'elle corresponde à l'intégralité du contenu d'une cellule. Sinon, la recherche est définie par défaut sur une correspondance partielle.

Paramètres

NomTypeDescription
matchEntireCellBooleanIndique si la cellule entière correspond.

Renvois

TextFinder : cet outil de recherche de texte, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

matchFormulaText(matchFormulaText)

Si la valeur est true, configure la recherche pour renvoyer les correspondances qui apparaissent dans le texte de la formule. Sinon, les cellules contenant des formules sont prises en compte en fonction de leur valeur affichée.

Paramètres

NomTypeDescription
matchFormulaTextBooleanIndique si la recherche examine le texte de la formule.

Renvois

TextFinder : cet outil de recherche de texte, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

replaceAllWith(replaceText)

Remplace toutes les correspondances par le texte spécifié. Renvoie le nombre d'occurrences remplacées, qui peut être différente du nombre de cellules correspondantes.

Paramètres

NomTypeDescription
replaceTextStringTexte qui remplace le texte dans les cellules correspondantes.

Renvois

Integer : nombre d'occurrences remplacées.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

replaceWith(replaceText)

Remplace le texte de recherche dans la cellule actuellement correspondante par le texte spécifié et renvoie le nombre d'occurrences remplacées.

Paramètres

NomTypeDescription
replaceTextStringTexte qui remplace le contenu de la cellule correspondante.

Renvois

Integer : nombre d'occurrences remplacées.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

startFrom(startRange)

Configure la recherche pour qu'elle commence immédiatement après la plage de cellules spécifiée.

Paramètres

NomTypeDescription
startRangeRangePlage de cellules au-delà de laquelle la recherche doit commencer.

Renvois

TextFinder : cet outil de recherche de texte, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

useRegularExpression(useRegEx)

Si la valeur est true, configure la recherche pour interpréter la chaîne de recherche comme une expression régulière. Sinon, la recherche interprète la chaîne de recherche comme un texte normal. Pour en savoir plus sur l'utilisation des expressions régulières, consultez la page d'assistance Rechercher et remplacer.

Paramètres

NomTypeDescription
useRegExBooleanInterpréter la chaîne de recherche comme une expression régulière.

Renvois

TextFinder : cet outil de recherche de texte, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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