Class RangeBuilder

Kreatorzakresów

Builder służący do tworzenia obiektów Range z elementów dokumentu.

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

Metody

Metoda	Zwracany typ	Krótki opis
addElement(element)	RangeBuilder	Dodaje całą listę Element do tej listy RangeBuilder.
addElement(textElement, startOffset, endOffsetInclusive)	RangeBuilder	Dodaje do tego RangeBuilder częściowy element Text.
addElementsBetween(startElement, endElementInclusive)	RangeBuilder	Dodaje do tego RangeBuilder 2 całe elementy i wszystkie elementy między nimi.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)	RangeBuilder	Do elementu RangeBuilder dodaje 2 częściowe elementy Text oraz wszystkie elementy między nimi.
addRange(range)	RangeBuilder	Dodaje zawartość innej Range do tej RangeBuilder.
build()	Range	Tworzy Range na podstawie ustawień zastosowanych w kreatorze.
getRangeElements()	RangeElement[]	Pobiera wszystkie elementy tego elementu Range, w tym elementy częściowe Text (np. w przypadku zaznaczenia obejmującego tylko część elementu Text).

Wycofane metody

Metoda	Zwracany typ	Krótki opis
getSelectedElements()	RangeElement[]	Pobiera wszystkie elementy wybrane przez użytkownika w otwartym dokumencie, w tym elementy częściowo wybrane Text.

Szczegółowa dokumentacja

addElement(element)

Dodaje całą listę Element do tej listy RangeBuilder.

Parametry

Nazwa	Typ	Opis
element	Element	element do dodania;

Powrót

RangeBuilder – ten kreator do łańcuchowania

Autoryzacja

Skrypty, które korzystają 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 do tego RangeBuilder częściowy element Text.

Parametry

Nazwa	Typ	Opis
textElement	Text	element tekstowy, który ma zostać częściowo dodany;
startOffset	Integer	liczba znaków przed pierwszym uwzględnianym znakiem (czyli indeks pierwszego znaku w zakresie);
endOffsetInclusive	Integer	liczba znaków przed ostatnim uwzględnianym znakiem (czyli indeks ostatniego znaku w zakresie);

Powrót

RangeBuilder – ten kreator do łańcuchowania

Autoryzacja

Skrypty, które korzystają 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 do tego RangeBuilder 2 całe elementy i wszystkie elementy między nimi.

Parametry

Nazwa	Typ	Opis
startElement	Element	pierwszy element do dodania.
endElementInclusive	Element	ostatni element do dodania.

Powrót

RangeBuilder – ten kreator do łańcuchowania

Autoryzacja

Skrypty, które korzystają 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)

Do elementu RangeBuilder dodaje 2 częściowe elementy Text oraz wszystkie elementy między nimi.

Parametry

Nazwa	Typ	Opis
startTextElement	Text	pierwszy element tekstowy, który ma zostać częściowo dodany;
startOffset	Integer	liczba znaków przed pierwszym znakiem ciągu startTextElement, które mają być uwzględnione (czyli indeks pierwszego znaku w zakresie);
endTextElementInclusive	Text	ostatni element tekstowy, który ma zostać częściowo dodany.
endOffsetInclusive	Integer	liczba znaków przed ostatnim znakiem ciągu endTextElementInclusive, który ma zostać uwzględniony (czyli indeks ostatniego znaku w zakresie);

Powrót

RangeBuilder – ten kreator do łańcuchowania

Autoryzacja

Skrypty, które korzystają 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ść innej Range do tej RangeBuilder.

Parametry

Nazwa	Typ	Opis
range	Range	zakres, którego elementy mają zostać dodane

Powrót

RangeBuilder – ten kreator do łańcuchowania

Autoryzacja

Skrypty, które korzystają 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()

Tworzy Range na podstawie ustawień zastosowanych w kreatorze.

Powrót

Range – nowo utworzony zakres

---

getRangeElements()

Pobiera wszystkie elementy tego elementu Range, w tym elementy częściowe Text (np. w przypadku zaznaczenia obejmującego tylko część elementu Text). Aby sprawdzić, czy element Text jest tylko częściowo uwzględniony w zakresie, zapoznaj się z artykułem RangeElement.isPartial().

Powrót

RangeElement[] – tablica elementów w kolejności, w jakiej występują w dokumencie

Autoryzacja

Skrypty, które korzystają 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()

Wycofany. Nazwa została zmieniona na getRangeElements().

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

Powrót

RangeElement[] – tablica wybranych lub częściowo wybranych elementów w kolejności, w jakiej występują w dokumencie

Autoryzacja

Skrypty, które korzystają 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