Class RangeBuilder

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

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 intermedi a questo RangeBuilder.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilderAggiunge due elementi Text parziali e tutti gli elementi intermedi al RangeBuilder.
addRange(range)RangeBuilderAggiunge i contenuti di un altro Range a questo RangeBuilder.
build()RangeCostruisce 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).

Documentazione dettagliata

addElement(element)

Aggiunge un intero Element a questo RangeBuilder.

Parametri

NomeTipoDescrizione
elementElementL'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

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)

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

NomeTipoDescrizione
startElementElementIl primo elemento da aggiungere
endElementInclusiveElementl'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

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)

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

NomeTipoDescrizione
rangeRangel'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