Class NamedRange

Intervallodenominato

Un Range con un nome e un ID per consentirne il recupero in un secondo momento. I nomi non sono necessariamente univoci; diversi intervalli nella stessa scheda possono condividere lo stesso nome, in modo simile a un 'classe in HTML. Al contrario, gli ID sono univoci all'interno della scheda, come un ID in HTML. Una volta aggiunto un NamedRange a una scheda, non può essere modificato, ma solo rimosso.

A un NamedRange può accedere qualsiasi script che accede alla scheda. Per evitare conflitti involontari tra gli script, ti consigliamo di anteporre ai nomi degli intervalli una stringa univoca.

// Create a named range that includes every table in the active tab.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

Metodi

Metodo	Tipo restituito	Breve descrizione
getId()	String	Recupera l'ID di questo NamedRange.
getName()	String	Recupera il nome di questo NamedRange.
getRange()	Range	Recupera l'intervallo di elementi associati a questo NamedRange.
remove()	void	Rimuove questo NamedRange dalla scheda.

Documentazione dettagliata

getId()

Recupera l'ID di questo NamedRange. L'ID è univoco all'interno della scheda.

Invio

String: l'ID dell'intervallo, univoco all'interno della scheda.

---

getName()

Recupera il nome di questo NamedRange. Il nome non è necessariamente univoco.

Invio

String: il nome dell'intervallo, che non è necessariamente univoco.

Autorizzazione

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

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

---

getRange()

Recupera l'intervallo di elementi associati a questo NamedRange.

Invio

Range: l'intervallo di elementi associati al nome e all'ID.

Autorizzazione

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

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

---

remove()

Rimuove questo NamedRange dalla scheda. Questo metodo non elimina i contenuti dell'intervallo, ma rimuove solo il riferimento. La chiamata di questo metodo su un NamedRange che è stato già rimosso non ha alcun effetto.

Autorizzazione

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

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