Class NamedRange

NamedRange

Creare, accedere e modificare gli intervalli denominati in un foglio di lavoro. Gli intervalli denominati sono intervalli con alias di stringa associati. Possono essere visualizzate e modificate tramite l'interfaccia utente di Fogli, alla voce Dati > Menu Intervalli denominati....

Metodi

MetodoTipo restituitoBreve descrizione
getName()StringOttiene il nome di questo intervallo denominato.
getRange()RangeRestituisce l'intervallo a cui fa riferimento questo intervallo denominato.
remove()voidElimina questo intervallo denominato.
setName(name)NamedRangeImposta/aggiorna il nome dell'intervallo denominato.
setRange(range)NamedRangeImposta/aggiorna l'intervallo per questo intervallo denominato.

Documentazione dettagliata

getName()

Ottiene il nome di questo intervallo denominato.

Invio

String: il nome di 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

getRange()

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

Invio

Range: l'intervallo del foglio di lavoro associato all'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()

Elimina questo intervallo denominato. 

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

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.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName("UpdatedNamedRange");
}

Parametri

NomeTipoDescrizione
nameStringIl nuovo nome dell'intervallo denominato.

Invio

NamedRange: l'intervallo il cui nome è stato impostato 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

NomeTipoDescrizione
rangeRangeL'intervallo del foglio di lavoro da associare a questo intervallo denominato.

Invio

NamedRange: l'intervallo denominato per il quale è 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