Class RangeBuilder

RangeBuilder

Un builder 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

MetodoTipo restituitoBreve descrizione
addElement(element)RangeBuilderAggiunge un intero Element a questo RangeBuilder.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilderAggiunge un elemento Text parziale a questo RangeBuilder.
addElementsBetween(startElement, endElementInclusive)RangeBuilderAggiunge due elementi interi e tutti gli elementi compresi tra questi a questo RangeBuilder.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilderAggiunge due elementi Text parziali e tutti gli elementi compresi tra questi all'elemento RangeBuilder.
addRange(range)RangeBuilderAggiunge i contenuti di un altro Range a questo RangeBuilder.
build()RangeCrea 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 una parte di un elemento Text).

Documentazione dettagliata

addElement(element)

Aggiunge un intero Element a questo RangeBuilder.

Parametri

NomeTipoDescrizione
elementElementl'elemento da aggiungere

Indietro

RangeBuilder: questo generatore, 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

NomeTipoDescrizione
textElementTextl'elemento di testo da aggiungere parzialmente
startOffsetIntegeril numero di caratteri prima del primo carattere da includere (ovvero, l'indice del primo carattere nell'intervallo)
endOffsetInclusiveIntegeril numero di caratteri prima dell'ultimo carattere da includere (ovvero l'indice dell'ultimo carattere nell'intervallo)

Indietro

RangeBuilder: questo generatore, 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 compresi tra questi a questo RangeBuilder.

Parametri

NomeTipoDescrizione
startElementElementil primo elemento da aggiungere
endElementInclusiveElementl'ultimo elemento da aggiungere

Indietro

RangeBuilder: questo generatore, 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 compresi tra questi all'elemento RangeBuilder.

Parametri

NomeTipoDescrizione
startTextElementTextil primo elemento di testo da aggiungere parzialmente
startOffsetIntegeril numero di caratteri prima del primo carattere di startTextElement da includere (ovvero l'indice del primo carattere nell'intervallo)
endTextElementInclusiveTextl'ultimo elemento di testo da aggiungere parzialmente
endOffsetInclusiveIntegeril numero di caratteri prima dell'ultimo carattere di endTextElementInclusive da includere (ovvero l'indice dell'ultimo carattere nell'intervallo)

Indietro

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

Parametri

NomeTipoDescrizione
rangeRangel'intervallo i cui elementi devono essere aggiunti

Indietro

RangeBuilder: questo generatore, 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()

Crea un Range dalle impostazioni applicate al builder.

Indietro

Range: l'intervallo appena costruito

getRangeElements()

Recupera tutti gli elementi in questo Range, inclusi eventuali elementi Text parziali (ad esempio, nel caso di una selezione che include solo una parte di un elemento Text). Per determinare se un elemento Text è incluso solo parzialmente nell'intervallo, consulta RangeElement.isPartial().

Indietro

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