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éthode | Type renvoyé | Brève description |
|---|---|---|
findAll() | Range[] | Affiche toutes les cellules correspondant aux critères de recherche. |
findNext() | Range | Affiche 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 actuellement sélectionnée correspondant aux critères de recherche. |
ignoreDiacritics(ignoreDiacritics) | TextFinder | 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. |
matchCase(matchCase) | TextFinder | 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. |
matchEntireCell(matchEntireCell) | TextFinder | 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. |
matchFormulaText(matchFormulaText) | TextFinder | 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. |
replaceAllWith(replaceText) | Integer | Remplace toutes les correspondances par le texte spécifié. |
replaceWith(replaceText) | Integer | Remplace le texte de recherche dans la cellule actuellement correspondante 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, 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
| Nom | Type | Description |
|---|---|---|
ignoreDiacritics | Boolean | Indique 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
| Nom | Type | Description |
|---|---|---|
matchCase | Boolean | Indique 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
| Nom | Type | Description |
|---|---|---|
matchEntireCell | Boolean | Indique 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
| Nom | Type | Description |
|---|---|---|
matchFormulaText | Boolean | Indique 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
| Nom | Type | Description |
|---|---|---|
replaceText | String | Texte 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
| Nom | Type | Description |
|---|---|---|
replaceText | String | Texte 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
| Nom | Type | Description |
|---|---|---|
startRange | Range | Plage 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
| Nom | Type | Description |
|---|---|---|
useRegEx | Boolean | Interpré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