Questa pagina è stata tradotta dall'API Cloud Translation.

Class RangeBuilder

Un generatore utilizzato per creare oggetti Range dagli elementi del documento.

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let 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 intermedi a questo `RangeBuilder`.
`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`	`RangeBuilder`	Aggiunge due elementi `Text` parziali e tutti gli elementi intermedi al `RangeBuilder`.
`addRange(range)`	`RangeBuilder`	Aggiunge i contenuti di un altro `Range` a questo `RangeBuilder`.
`build()`	`Range`	Costruisce un `Range` dalle impostazioni applicate al generatore.
`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`).

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
`getSelectedElements()`	`RangeElement[]`	Recupera tutti gli elementi selezionati dall'utente nell'istanza aperta del documento, inclusi eventuali elementi `Text` selezionati parzialmente.

Documentazione dettagliata

`addElement(element)`

Aggiunge un intero Element a questo RangeBuilder.

Parametri

Nome	Tipo	Descrizione
`element`	`Element`	L'elemento da aggiungere

Invio

RangeBuilder: questo generatore, per l'accodamento

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 (ovvero l'indice del primo carattere nell'intervallo)
`endOffsetInclusive`	`Integer`	il numero di caratteri prima dell'ultimo carattere da includere (ovvero l'indice dell'ultimo carattere nell'intervallo)

Invio

RangeBuilder: questo generatore, per l'accodamento

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 intermedi a questo RangeBuilder.

Parametri

Nome	Tipo	Descrizione
`startElement`	`Element`	Il primo elemento da aggiungere
`endElementInclusive`	`Element`	l'ultimo elemento da aggiungere

Invio

RangeBuilder: questo generatore, per l'accodamento

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 intermedi al 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 nell'intervallo)

Invio

RangeBuilder: questo generatore, per l'accodamento

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 Range a questo RangeBuilder.

Parametri

Nome	Tipo	Descrizione
`range`	`Range`	l'intervallo di cui devono essere aggiunti gli elementi

Invio

RangeBuilder: questo generatore, per l'accodamento

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()`

Costruisce un Range dalle impostazioni applicate al generatore.

Invio

Range: l'intervallo appena creato

`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 elemento Text è 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

Metodi ritirati

`getSelectedElements()`

Ritiro. Rinominato in getRangeElements().

Recupera tutti gli elementi selezionati dall'utente nell'istanza aperta del documento, inclusi eventuali elementi Text selezionati parzialmente.

Invio

RangeElement[]: un array di elementi selezionati o parzialmente selezionati, 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