Un builder utilizzato per creare oggetti Range
a partire da elementi di documenti.
// Change the user's selection to a range that includes every table in the active tab. var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var rangeBuilder = documentTab.newRange(); var tables = documentTab.getBody().getTables(); for (var i = 0; i < tables.length; i++) { rangeBuilder.addElement(tables[i]); } doc.setSelection(rangeBuilder.build());
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addElement(element) | RangeBuilder | Aggiunge un intero Element a questo RangeBuilder . |
addElement(textElement, startOffset, endOffsetInclusive) | RangeBuilder | Aggiunge un elemento Text parziale a questo RangeBuilder . |
addElementsBetween(startElement, endElementInclusive) | RangeBuilder | Aggiunge due elementi interi, e tutti gli elementi tra di essi, a RangeBuilder . |
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive) | RangeBuilder | Aggiunge due elementi Text parziali e tutti gli elementi tra di loro, alla RangeBuilder . |
addRange(range) | RangeBuilder | Aggiunge i contenuti di un altro elemento Range a questo RangeBuilder . |
build() | Range | Crea un Range dalle impostazioni applicate al builder. |
getRangeElements() | RangeElement[] | Recupera tutti gli elementi in questo Range , inclusi eventuali elementi Text parziali (ad esempio, nel caso
di una selezione che include solo parte di un elemento Text ). |
Documentazione dettagliata
addElement(element)
Aggiunge un intero Element
a questo RangeBuilder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
element | Element | l'elemento da aggiungere |
Invio
RangeBuilder
: questo builder, per il concatenamento
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
addElement(textElement, startOffset, endOffsetInclusive)
Aggiunge un elemento Text
parziale a questo RangeBuilder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
textElement | Text | l'elemento di testo da aggiungere parzialmente |
startOffset | Integer | il numero di caratteri prima del primo carattere da includere (ossia, l'indice del primo carattere nell'intervallo) |
endOffsetInclusive | Integer | il numero di caratteri prima dell'ultimo carattere da includere (vale a dire, l'indice dell'ultimo carattere dell'intervallo) |
Invio
RangeBuilder
: questo builder, per il concatenamento
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
addElementsBetween(startElement, endElementInclusive)
Aggiunge due elementi interi, e tutti gli elementi tra di essi, a RangeBuilder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startElement | Element | il primo elemento da aggiungere |
endElementInclusive | Element | l'ultimo elemento da aggiungere |
Invio
RangeBuilder
: questo builder, per il concatenamento
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
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)
Aggiunge due elementi Text
parziali e tutti gli elementi tra di loro, alla RangeBuilder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startTextElement | Text | il primo elemento di testo da aggiungere parzialmente |
startOffset | Integer | il numero di caratteri prima del primo carattere di startTextElement da includere (ovvero l'indice del primo carattere nell'intervallo) |
endTextElementInclusive | Text | l'ultimo elemento di testo da aggiungere parzialmente |
endOffsetInclusive | Integer | il numero di caratteri prima dell'ultimo carattere di endTextElementInclusive da includere (ovvero l'indice dell'ultimo carattere nella
intervallo) |
Invio
RangeBuilder
: questo builder, per il concatenamento
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
addRange(range)
Aggiunge i contenuti di un altro elemento Range
a questo RangeBuilder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | l'intervallo i cui elementi devono essere aggiunti |
Invio
RangeBuilder
: questo builder, per il concatenamento
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
build()
getRangeElements()
Recupera tutti gli elementi in questo Range
, inclusi eventuali elementi Text
parziali (ad esempio, nel caso
di una selezione che include solo parte di un elemento Text
). Per determinare se un
Text
elemento è incluso solo parzialmente nell'intervallo. Consulta RangeElement.isPartial()
.
Invio
RangeElement[]
: un array di elementi, nell'ordine in cui appaiono nel documento
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