Rechercher ou remplacer 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 actuellement correspondant aux critères de recherche. |
ignoreDiacritics(ignoreDiacritics) | TextFinder | Si la valeur est true, la recherche est configurée pour ignorer les caractères diacritiques lors de la mise en correspondance. Sinon, elle correspond aux caractères diacritiques. |
matchCase(matchCase) | TextFinder | Si la valeur est true, la recherche est configurée pour correspondre exactement à la casse du texte de la recherche. Dans le cas contraire, la recherche utilise par défaut une correspondance non sensible à la casse. |
matchEntireCell(matchEntireCell) | TextFinder | Si la valeur est true, la recherche est configurée pour correspondre à l'ensemble 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 qu'elle renvoie les correspondances qui apparaissent dans le texte d'une formule. Sinon, les cellules contenant des formules sont considérées 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 la recherche par le texte spécifié dans la cellule 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 est interprétée comme une expression régulière par la recherche. Dans le cas contraire, la chaîne est interprétée comme un texte normal. |
Documentation détaillée
findAll()
Renvoie toutes les cellules correspondant aux critères de recherche.
Aller-retour
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.
Aller-retour
Range : cellule suivante correspondante, ou null en l'absence 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
findPrevious()
Renvoie la cellule précédente correspondant aux critères de recherche.
Aller-retour
Range : cellule précédente correspondante ou null si aucune correspondance précédente n'a été trouvée.
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 actuellement correspondant aux critères de recherche.
Aller-retour
Range : cellule correspondante actuelle, ou null si aucune autre correspondance n'est trouvée.
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 est configurée pour ignorer les caractères diacritiques lors de la mise en correspondance. Sinon, elle correspond aux caractères 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 différent.
Paramètres
| Nom | Type | Description |
|---|---|---|
ignoreDiacritics | Boolean | Indique si la recherche tient compte des signes diacritiques. |
Aller-retour
TextFinder : cet 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 la recherche. Dans le cas contraire, la recherche utilise par défaut une correspondance non sensible à la casse.
Paramètres
| Nom | Type | Description |
|---|---|---|
matchCase | Boolean | Indique si la correspondance est sensible à la casse. |
Aller-retour
TextFinder : cet 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 la valeur est true, la recherche est configurée pour correspondre à l'ensemble 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. |
Aller-retour
TextFinder : cet 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 la valeur est true, configure la recherche pour qu'elle renvoie les correspondances qui apparaissent dans le texte d'une formule. Sinon, les cellules contenant des formules sont considérées en fonction de leur valeur affichée.
Paramètres
| Nom | Type | Description |
|---|---|---|
matchFormulaText | Boolean | Indique si la recherche examine le texte des formules. |
Aller-retour
TextFinder : cet 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 correspondantes.
Paramètres
| Nom | Type | Description |
|---|---|---|
replaceText | String | Texte qui remplace le texte dans les cellules correspondantes. |
Aller-retour
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 la recherche par le texte spécifié dans la cellule et renvoie le nombre d'occurrences remplacées.
Paramètres
| Nom | Type | Description |
|---|---|---|
replaceText | String | Texte qui remplace le contenu de la cellule actuellement correspondante. |
Aller-retour
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 après laquelle la recherche doit commencer. |
Aller-retour
TextFinder : cet 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 est interprétée comme une expression régulière par la recherche. Dans le cas contraire, la chaîne est interprétée comme un texte normal. Pour en savoir plus sur l'utilisation d'expressions régulières, consultez la page Rechercher et remplacer.
Paramètres
| Nom | Type | Description |
|---|---|---|
useRegEx | Boolean | Indique si la chaîne de recherche doit être interprétée comme une expression régulière. |
Aller-retour
TextFinder : cet 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