Class NamedRange

Intervallodenominato

Crea, accedi e modifica gli intervalli denominati in un foglio di lavoro. Gli intervalli denominati sono intervalli con alias di stringa associati. Possono essere visualizzati e modificati tramite l'interfaccia utente di Fogli nel menu Dati > Intervalli denominati.

Metodi

Metodo	Tipo restituito	Breve descrizione
getName()	String	Restituisce il nome di questo intervallo denominato.
getRange()	Range	Recupera l'intervallo a cui fa riferimento questo intervallo denominato.
remove()	void	Consente di eliminare questo intervallo denominato.
setName(name)	NamedRange	Imposta/aggiorna il nome dell'intervallo denominato.
setRange(range)	NamedRange	Imposta/aggiorna l'intervallo per questo intervallo denominato.

Documentazione dettagliata

getName()

Restituisce il nome di questo intervallo denominato.

Invio

String: il nome dell'intervallo denominato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getRange()

Recupera l'intervallo a cui fa riferimento questo intervallo denominato.

Invio

Range: l'intervallo del foglio di lavoro associato a questo intervallo denominato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

remove()

Consente di eliminare questo intervallo denominato.

// 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();
}

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setName(name)

Imposta/aggiorna il nome dell'intervallo denominato.

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

Parametri

Nome	Tipo	Descrizione
name	String	Il nuovo nome dell'intervallo denominato.

Invio

NamedRange: l'intervallo di cui è stato impostato il nome dalla chiamata

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setRange(range)

Imposta/aggiorna l'intervallo per questo intervallo denominato.

Parametri

Nome	Tipo	Descrizione
range	Range	L'intervallo del foglio di lavoro da associare a questo intervallo denominato.

Invio

NamedRange: l'intervallo denominato per cui è stato impostato l'intervallo del foglio di lavoro

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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