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 |
---|---|---|
add | Range | Fügt diesem Range eine vollständige Element hinzu. |
add | Range | Fügt diesem Range ein teilweises Text -Element hinzu. |
add | Range | Fügen Sie diesem Range zwei vollständige Elemente und alle Elemente dazwischen hinzu. |
add | Range | Dem Range werden zwei teilweise Text -Elemente und alle Elemente dazwischen hinzugefügt. |
add | Range | Fügt diesem Range den Inhalt einer anderen Range hinzu. |
build() | Range | Erstellt ein Range aus den auf den Builder angewendeten Einstellungen. |
get | Range | 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 |
---|---|---|
| Range | 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 Range
eine vollständige Element
hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
element | Element | das hinzuzufügende Element |
Rückflug
Range
– 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 Range
ein teilweises Text
-Element hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | Text | das Textelement, das teilweise hinzugefügt werden soll |
start | Integer | die Anzahl der Zeichen vor dem ersten Zeichen, das eingeschlossen werden soll (d. h. der Index des ersten Zeichens im Bereich) |
end | Integer | die Anzahl der Zeichen vor dem letzten Zeichen, das eingeschlossen werden soll (d. h. der Index des letzten Zeichens im Bereich) |
Rückflug
Range
– 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 Range
zwei vollständige Elemente und alle Elemente dazwischen hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
start | Element | das erste hinzuzufügende Element |
end | Element | das letzte hinzugefügte Element |
Rückflug
Range
– 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 Range
werden zwei teilweise Text
-Elemente und alle Elemente dazwischen hinzugefügt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
start | Text | das erste Textelement, das teilweise hinzugefügt werden soll |
start | Integer | die Anzahl der Zeichen vor dem ersten Zeichen von start , das eingeschlossen werden soll (d. h. der Index des ersten Zeichens im Bereich) |
end | Text | das letzte Textelement, das teilweise hinzugefügt werden soll |
end | Integer | die Anzahl der Zeichen vor dem letzten Zeichen von end , das eingeschlossen werden soll (d. h. der Index des letzten Zeichens im Bereich) |
Rückflug
Range
– 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 Range
den Inhalt einer anderen Range
hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
range | Range | den Bereich, dessen Elemente hinzugefügt werden sollen |
Rückflug
Range
– 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 Range
.
Rückflug
Range
: 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()
getSelectedElements()
Veraltet. Wurde in get
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
Range
: 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