Créer des plages nommées, y accéder et les modifier dans une feuille de calcul Les plages nommées sont des plages contenant des alias de chaîne associés. Vous pouvez les afficher et les modifier dans l'interface utilisateur de Sheets, sous le menu Données > Plages nommées.
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
getName() | String | Récupère le nom de cette plage nommée. |
getRange() | Range | Récupère la plage référencée par cette plage nommée. |
remove() | void | Supprime cette plage nommée. |
setName(name) | NamedRange | Définit/met à jour le nom de la plage nommée. |
setRange(range) | NamedRange | Définit/met à jour la plage pour cette plage nommée. |
Documentation détaillée
getName()
Récupère le nom de cette plage nommée.
Renvois
String : nom de cette plage nommée
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
getRange()
Récupère la plage référencée par cette plage nommée.
Renvois
Range : plage de la feuille de calcul associée à cette plage nommée
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
remove()
Supprime cette plage nommée.
// The code below deletes all the named ranges in the spreadsheet.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
namedRanges[i].remove();
}
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
setName(name)
Définit/met à jour le nom de la plage nommée.
// The code below updates the name for the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
namedRanges[0].setName("UpdatedNamedRange");
}
Paramètres
| Nom | Type | Description |
|---|---|---|
name | String | Nouveau nom de la plage nommée. |
Renvois
NamedRange : plage dont le nom a été défini par l'appel
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
setRange(range)
Définit/met à jour la plage pour cette plage nommée.
Paramètres
| Nom | Type | Description |
|---|---|---|
range | Range | Plage de la feuille de calcul à associer à cette plage nommée. |
Renvois
NamedRange : plage nommée pour laquelle la plage de la feuille de calcul a été définie
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