Class NamedRange

NamedRange

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

Un NamedRange può essere accessibile da qualsiasi script che accede alla scheda. Per evitare conflitti involontari tra gli script, valuta la possibilità di aggiungere un prefisso ai nomi degli intervalli con 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

MetodoTipo restituitoBreve descrizione
getId()StringRecupera l'ID di questo NamedRange.
getName()StringRestituisce il nome di questo NamedRange.
getRange()RangeRecupera l'intervallo di elementi associati a questo NamedRange.
remove()voidRimuove questo NamedRange dalla scheda.

Documentazione dettagliata

getId()

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

Indietro

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

getName()

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

Indietro

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.

Indietro

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 solo il riferimento. La chiamata di questo metodo su un NamedRange che è già stato rimosso non ha 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