Kreator służący do tworzenia obiektów Range
na podstawie elementów dokumentu.
// Change the user's selection to a range that includes every table in the document. var doc = DocumentApp.getActiveDocument(); var rangeBuilder = doc.newRange(); var tables = doc.getBody().getTables(); for (var i = 0; i < tables.length; i++) { rangeBuilder.addElement(tables[i]); } doc.setSelection(rangeBuilder.build());
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addElement(element) | RangeBuilder | Dodaje cały obiekt Element do: RangeBuilder . |
addElement(textElement, startOffset, endOffsetInclusive) | RangeBuilder | Dodaje częściowy element Text do elementu RangeBuilder . |
addElementsBetween(startElement, endElementInclusive) | RangeBuilder | Dodaje 2 całe elementy oraz wszystkie elementy między nimi do tego elementu RangeBuilder . |
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive) | RangeBuilder | Dodaje 2 częściowe elementy Text i wszystkie elementy między nimi do elementu RangeBuilder . |
addRange(range) | RangeBuilder | Dodaje zawartość innego elementu Range do tego elementu RangeBuilder . |
build() | Range | Konstruuje Range na podstawie ustawień zastosowanych do kreatora. |
getRangeElements() | RangeElement[] | Pobiera wszystkie elementy w elemencie Range , w tym częściowe elementy Text (np. w przypadku wyboru zawierającego tylko część elementu Text ). |
Szczegółowa dokumentacja
addElement(element)
Dodaje cały obiekt Element
do: RangeBuilder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
element | Element | element do dodania |
Powroty
RangeBuilder
– ten kreator do tworzenia łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
addElement(textElement, startOffset, endOffsetInclusive)
Dodaje częściowy element Text
do elementu RangeBuilder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
textElement | Text | element tekstowy, który ma zostać dodany częściowo |
startOffset | Integer | liczba znaków przed pierwszym znakiem, który ma zostać uwzględniony (czyli indeks pierwszego znaku w zakresie) |
endOffsetInclusive | Integer | liczba znaków przed ostatnim znakiem, który ma być uwzględniony (czyli indeksem ostatniego znaku w zakresie) |
Powroty
RangeBuilder
– ten kreator do tworzenia łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
addElementsBetween(startElement, endElementInclusive)
Dodaje 2 całe elementy oraz wszystkie elementy między nimi do tego elementu RangeBuilder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
startElement | Element | pierwszy element do dodania |
endElementInclusive | Element | ostatni element do dodania |
Powroty
RangeBuilder
– ten kreator do tworzenia łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)
Dodaje 2 częściowe elementy Text
i wszystkie elementy między nimi do elementu RangeBuilder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
startTextElement | Text | pierwszy element tekstowy, który zostanie częściowo dodany; |
startOffset | Integer | liczba znaków przed pierwszym znakiem argumentu startTextElement , który ma zostać uwzględniony (czyli indeks pierwszego znaku w zakresie) |
endTextElementInclusive | Text | ostatni element tekstowy do częściowego dodania, |
endOffsetInclusive | Integer | liczba znaków przed ostatnim znakiem elementu endTextElementInclusive , który ma być uwzględniony (czyli indeksem ostatniego znaku w zakresie) |
Powroty
RangeBuilder
– ten kreator do tworzenia łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
addRange(range)
Dodaje zawartość innego elementu Range
do tego elementu RangeBuilder
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
range | Range | zakres, do którego należy dodać elementy |
Powroty
RangeBuilder
– ten kreator do tworzenia łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
build()
Konstruuje Range
na podstawie ustawień zastosowanych do kreatora.
Powroty
Range
– nowo utworzony zakres.
getRangeElements()
Pobiera wszystkie elementy w elemencie Range
, w tym częściowe elementy Text
(np. w przypadku wyboru zawierającego tylko część elementu Text
). Aby sprawdzić, czy element Text
jest uwzględniony w zakresie tylko częściowo, zobacz RangeElement.isPartial()
.
Powroty
RangeElement[]
– tablica elementów w kolejności, w jakiej występują w dokumencie;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents