Un elemento Range che abbia un nome e un ID per consentirne il recupero in un secondo momento. I nomi non sono
necessariamente univoco; diversi intervalli nella stessa scheda possono condividere lo stesso nome, proprio come un
in HTML. Al contrario, gli ID sono univoci all'interno della scheda, come un ID nel codice HTML. Una volta aggiunto un NamedRange a una scheda, non può essere modificato, ma solo rimosso.
Un NamedRange è accessibile da qualsiasi script che accede alla scheda. Per evitare indesiderate
i conflitti tra gli script, considera l'idea di anteporre ai nomi degli intervalli una stringa univoca.
// Create a named range that includes every table in the active tab.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
getId() | String | Ottiene l'ID di questo NamedRange. |
getName() | String | Ottiene il nome di questo NamedRange. |
getRange() | Range | Restituisce l'intervallo di elementi associati a NamedRange. |
remove() | void | Rimuove NamedRange dalla scheda. |
Documentazione dettagliata
getId()
Ottiene l'ID di questo NamedRange. L'ID è univoco all'interno della scheda.
Invio
String: ID dell'intervallo, univoco all'interno della scheda.
getName()
Ottiene 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()
Restituisce l'intervallo di elementi associati a 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 NamedRange dalla scheda. Questo metodo non elimina i contenuti dei campi
intervallo; rimuove solo il riferimento. Chiamata a questo metodo su un NamedRange che
è già stato 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