Un elemento Range con nome e ID per consentire il recupero successivo. I nomi non sono necessariamente univoci; diversi intervalli diversi nello stesso documento possono condividere lo stesso nome, proprio come una classe in HTML. Gli ID, invece, sono univoci all'interno del documento, come gli ID in HTML. Una volta aggiunto un elemento NamedRange a un documento, non puoi modificarlo, ma solo rimuoverlo.
È possibile accedere a NamedRange da qualsiasi script che accede al documento. Per evitare conflitti involontari tra gli script, ti consigliamo di anteporre una stringa univoca ai nomi degli intervalli.
// Create a named range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
doc.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 NamedRange. |
getRange() | Range | Restituisce l'intervallo di elementi associati a questo NamedRange. |
remove() | void | Rimuove questo NamedRange dal documento. |
Documentazione dettagliata
getId()
Recupera l'ID di questo NamedRange. L'ID è univoco all'interno del documento.
Ritorni
String: ID dell'intervallo, univoco all'interno del documento
getName()
Recupera il nome di NamedRange. Il nome non è necessariamente univoco.
Ritorni
String: 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 questo NamedRange.
Ritorni
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 dal documento. Questo metodo non elimina i contenuti dell'intervallo, ma semplicemente rimuove il riferimento. La chiamata di 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