Cette page a été traduite par l'API Cloud Translation.

Class TextFinder

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

Méthodes

Méthode	Type renvoyé	Brève description
`findAll()`	`Range[]`	Renvoie toutes les cellules correspondant aux critères de recherche.
`findNext()`	`Range`	Renvoie la cellule suivante correspondant aux critères de recherche.
`findPrevious()`	`Range`	Renvoie la cellule précédente correspondant aux critères de recherche.
`getCurrentMatch()`	`Range`	Renvoie la cellule actuelle correspondant aux critères de recherche.
`ignoreDiacritics(ignoreDiacritics)`	`TextFinder`	Si la valeur est `true`, la recherche ignore les signes diacritiques lors de la mise en correspondance. Sinon, la recherche correspond aux signes diacritiques.
`matchCase(matchCase)`	`TextFinder`	Si la valeur est `true`, la recherche est configurée pour correspondre exactement à la casse du texte de recherche. Sinon, la recherche est sensible à la casse par défaut.
`matchEntireCell(matchEntireCell)`	`TextFinder`	Si `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 la correspondance partielle.
`matchFormulaText(matchFormulaText)`	`TextFinder`	Si `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)`	`Integer`	Remplace toutes les correspondances par le texte spécifié.
`replaceWith(replaceText)`	`Integer`	Remplace le texte de recherche dans la cellule actuellement mise en correspondance par le texte spécifié et renvoie le nombre d'occurrences remplacées.
`startFrom(startRange)`	`TextFinder`	Configure la recherche pour qu'elle commence immédiatement après la plage de cellules spécifiée.
`useRegularExpression(useRegEx)`	`TextFinder`	Si la valeur est `true`, la recherche interprète la chaîne de recherche comme une expression régulière. Sinon, la recherche interprète la chaîne de recherche comme du texte normal.

Documentation détaillée

`findAll()`

Renvoie 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 avec un ou plusieurs des champs d'application suivants:

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

`findNext()`

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

Renvois

Range : cellule suivante correspondant, ou null s'il n'y a pas de correspondances précédentes.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 s'il n'y a pas de correspondance précédente.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 actuelle 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 avec 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, la recherche ignore les signes diacritiques lors de la mise en correspondance. Sinon, la recherche correspond aux signes 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'elle n'est pas marquée ou marquée différemment.

Paramètres

Nom	Type	Description
`ignoreDiacritics`	`Boolean`	Indique si la recherche prend en compte les diacritiques.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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, la recherche est configurée pour correspondre exactement à la casse du texte de recherche. Sinon, la recherche est sensible à la casse par défaut.

Paramètres

Nom	Type	Description
`matchCase`	`Boolean`	Indique si la correspondance est sensible à la casse.

Renvois

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

Autorisation

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

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

`matchEntireCell(matchEntireCell)`

Si 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 la correspondance partielle.

Paramètres

Nom	Type	Description
`matchEntireCell`	`Boolean`	Indique si l'ensemble de la cellule est mis en correspondance.

Renvois

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

Autorisation

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

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

`matchFormulaText(matchFormulaText)`

Si 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

Nom	Type	Description
`matchFormulaText`	`Boolean`	Indique si la recherche examine le texte de la formule.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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érent du nombre de cellules correspondant.

Paramètres

Nom	Type	Description
`replaceText`	`String`	Texte qui remplace le texte des cellules correspondantes.

Renvois

Integer : nombre d'occurrences remplacées.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 mise en correspondance par le texte spécifié et renvoie le nombre d'occurrences remplacées.

Paramètres

Nom	Type	Description
`replaceText`	`String`	Texte qui remplace le contenu de la cellule actuellement mise en correspondance.

Renvois

Integer : nombre d'occurrences remplacées.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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

Nom	Type	Description
`startRange`	`Range`	Plage de cellules à partir de laquelle la recherche doit commencer.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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, la recherche interprète la chaîne de recherche comme une expression régulière. Sinon, la recherche interprète la chaîne de recherche comme du texte normal. Pour en savoir plus sur l'utilisation des expressions régulières, consultez la page d'assistance sur la recherche et le remplacement.

Paramètres

Nom	Type	Description
`useRegEx`	`Boolean`	Indique si la chaîne de recherche doit être interprétée en tant qu'expression régulière.

Renvois

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

Autorisation

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

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