Diese Seite wurde von der Cloud Translation API übersetzt.

Class RangeBuilder

Ein Builder, mit dem Range-Objekte aus Dokumentelementen erstellt werden.

// 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());

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`addElement(element)`	`RangeBuilder`	Fügt diesem `RangeBuilder` eine vollständige `Element` hinzu.
`addElement(textElement, startOffset, endOffsetInclusive)`	`RangeBuilder`	Fügt diesem `RangeBuilder` ein teilweises `Text`-Element hinzu.
`addElementsBetween(startElement, endElementInclusive)`	`RangeBuilder`	Fügen Sie diesem `RangeBuilder` zwei vollständige Elemente und alle Elemente dazwischen hinzu.
`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`	`RangeBuilder`	Dem `RangeBuilder` werden zwei teilweise `Text`-Elemente und alle Elemente dazwischen hinzugefügt.
`addRange(range)`	`RangeBuilder`	Fügt diesem `RangeBuilder` den Inhalt einer anderen `Range` hinzu.
`build()`	`Range`	Erstellt ein `Range` aus den auf den Builder angewendeten Einstellungen.
`getRangeElements()`	`RangeElement[]`	Hiermit werden alle Elemente in dieser `Range` abgerufen, einschließlich teilweiser `Text`-Elemente (z. B. bei einer Auswahl, die nur einen Teil eines `Text`-Elements enthält).

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getSelectedElements()`	`RangeElement[]`	Hiermit werden alle Elemente abgerufen, die der Nutzer in der geöffneten Instanz des Dokuments ausgewählt hat, einschließlich teilweise ausgewählter `Text`-Elemente.

Detaillierte Dokumentation

`addElement(element)`

Fügt diesem RangeBuilder eine vollständige Element hinzu.

Parameter

Name	Typ	Beschreibung
`element`	`Element`	das hinzuzufügende Element

Rückflug

RangeBuilder – dieser Builder, zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`addElement(textElement, startOffset, endOffsetInclusive)`

Fügt diesem RangeBuilder ein teilweises Text-Element hinzu.

Parameter

Name	Typ	Beschreibung
`textElement`	`Text`	das Textelement, das teilweise hinzugefügt werden soll
`startOffset`	`Integer`	die Anzahl der Zeichen vor dem ersten Zeichen, das eingeschlossen werden soll (d. h. der Index des ersten Zeichens im Bereich)
`endOffsetInclusive`	`Integer`	die Anzahl der Zeichen vor dem letzten Zeichen, das eingeschlossen werden soll (d. h. der Index des letzten Zeichens im Bereich)

Rückflug

RangeBuilder – dieser Builder, zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`addElementsBetween(startElement, endElementInclusive)`

Fügen Sie diesem RangeBuilder zwei vollständige Elemente und alle Elemente dazwischen hinzu.

Parameter

Name	Typ	Beschreibung
`startElement`	`Element`	das erste hinzuzufügende Element
`endElementInclusive`	`Element`	das letzte hinzugefügte Element

Rückflug

RangeBuilder – dieser Builder, zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`

Dem RangeBuilder werden zwei teilweise Text-Elemente und alle Elemente dazwischen hinzugefügt.

Parameter

Name	Typ	Beschreibung
`startTextElement`	`Text`	das erste Textelement, das teilweise hinzugefügt werden soll
`startOffset`	`Integer`	die Anzahl der Zeichen vor dem ersten Zeichen von `startTextElement`, das eingeschlossen werden soll (d. h. der Index des ersten Zeichens im Bereich)
`endTextElementInclusive`	`Text`	das letzte Textelement, das teilweise hinzugefügt werden soll
`endOffsetInclusive`	`Integer`	die Anzahl der Zeichen vor dem letzten Zeichen von `endTextElementInclusive`, das eingeschlossen werden soll (d. h. der Index des letzten Zeichens im Bereich)

Rückflug

RangeBuilder – dieser Builder, zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`addRange(range)`

Fügt diesem RangeBuilder den Inhalt einer anderen Range hinzu.

Parameter

Name	Typ	Beschreibung
`range`	`Range`	den Bereich, dessen Elemente hinzugefügt werden sollen

Rückflug

RangeBuilder – dieser Builder, zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`build()`

Erstellt ein Range aus den auf den Builder angewendeten Einstellungen.

Rückflug

Range – der neu erstellte Bereich

`getRangeElements()`

Hiermit werden alle Elemente in dieser Range abgerufen, einschließlich teilweiser Text-Elemente (z. B. bei einer Auswahl, die nur einen Teil eines Text-Elements enthält). Ob ein Text-Element nur teilweise im Bereich enthalten ist, sehen Sie unter RangeElement.isPartial().

Rückflug

RangeElement[]: ein Array von Elementen in der Reihenfolge, in der sie im Dokument erscheinen

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

Eingestellte Methoden

`getSelectedElements()`

Veraltet. Wurde in getRangeElements() umbenannt.

Hiermit werden alle Elemente abgerufen, die der Nutzer in der geöffneten Instanz des Dokuments ausgewählt hat, einschließlich teilweise ausgewählter Text-Elemente.

Rückflug

RangeElement[]: ein Array aus ausgewählten oder teilweise ausgewählten Elementen in der Reihenfolge, in der sie im Dokument erscheinen

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents