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

Class NamedRange

Créer, consulter et modifier des plages nommées dans une feuille de calcul. Les plages nommées sont des plages qui ont les alias de chaîne associés. Vous pouvez les afficher et les modifier dans l'interface utilisateur de Sheets, sous 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 correspondant à 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 correspondant à 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 correspondant à 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 correspondant à 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 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 correspondant à un ou plusieurs des champs d'application suivants:

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