Ta strona została przetłumaczona przez Cloud Translation API.

Class RangeBuilder

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`).

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`getSelectedElements()`	`RangeElement[]`	Pobiera wszystkie elementy wybrane przez użytkownika w otwartym instancji dokumentu, w tym częściowo wybrane elementy `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

Wycofane metody

`getSelectedElements()`

Wycofano. Zmieniono nazwę na getRangeElements().

Pobiera wszystkie elementy wybrane przez użytkownika w otwartym instancji dokumentu, w tym częściowo wybrane elementy Text.

Powroty

RangeElement[] – tablica wybranych lub częściowo wybranych elementów w kolejności, w jakiej są one wyświetlane 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