Class NamedRange

NamedRange

Créez, modifiez des plages nommées et accédez-y dans une feuille de calcul. Les plages nommées sont des plages auxquelles des alias de chaîne sont associés. Vous pouvez les afficher et les modifier dans l'interface utilisateur de Sheets, dans 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 avec 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 avec 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.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

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

---

setName(name)

Définit/met à jour le nom de la plage nommée.

// The code below updates the name for the first named range.
const 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 avec 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 avec un ou plusieurs des champs d'application suivants :

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