Class RangeBuilder

RangeBuilder

Kreator używany 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.
var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.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 element Element do elementu RangeBuilder.
addElement(textElement, startOffset, endOffsetInclusive)	RangeBuilder	Dodaje częściowy element Text do tego elementu (RangeBuilder).
addElementsBetween(startElement, endElementInclusive)	RangeBuilder	Dodaje do tego elementu RangeBuilder 2 całe elementy i wszystkie elementy między nimi.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)	RangeBuilder	Dodaje do pola RangeBuilder 2 częściowe elementy Text i wszystkie elementy między nimi.
addRange(range)	RangeBuilder	Dodaje zawartość innego elementu Range do tego elementu (RangeBuilder).
build()	Range	Tworzy obiekt Range na podstawie ustawień zastosowanych w kreatorze.
getRangeElements()	RangeElement[]	Pobiera wszystkie elementy w tym elemencie typu Range, w tym częściowe elementy Text (na przykład w przypadku argumentu takiego, który zawiera tylko część elementu Text).

Wycofane metody

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

Szczegółowa dokumentacja

addElement(element)

Dodaje cały element Element do elementu RangeBuilder.

Parametry

Nazwa	Typ	Opis
element	Element	element, który ma zostać dodany

Powrót

RangeBuilder – ten kreator do tworzenia łańcuchów

Autoryzacja

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 tego elementu (RangeBuilder).

Parametry

Nazwa	Typ	Opis
textElement	Text	element tekstowy do częściowego dodania
startOffset	Integer	liczbę znaków przed pierwszym uwzględnionym znakiem (tzn. indeks pierwszego znaku w zakresie)
endOffsetInclusive	Integer	liczbę znaków przed ostatnim podanym znakiem (czyli indeks ostatniego znaku w zakresie)

Powrót

RangeBuilder – ten kreator do tworzenia łańcuchów

Autoryzacja

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 do tego elementu 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 tworzenia łańcuchów

Autoryzacja

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 do pola RangeBuilder 2 częściowe elementy Text i wszystkie elementy między nimi.

Parametry

Nazwa	Typ	Opis
startTextElement	Text	pierwszy element tekstowy do częściowego dodania
startOffset	Integer	liczba znaków przed pierwszym znakiem z startTextElement do uwzględnienia (czyli indeks pierwszego znaku w zakresie)
endTextElementInclusive	Text	ostatni element tekstowy do częściowego dodania
endOffsetInclusive	Integer	liczbę znaków przed ostatnim znakiem endTextElementInclusive do uwzględnienia (czyli indeks ostatniego znaku w argumencie zakres)

Powrót

RangeBuilder – ten kreator do tworzenia łańcuchów

Autoryzacja

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, którego elementy mają zostać dodane

Powrót

RangeBuilder – ten kreator do tworzenia łańcuchów

Autoryzacja

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

Tworzy obiekt Range na podstawie ustawień zastosowanych w kreatorze.

Powrót

Range – nowo utworzony zakres.

---

getRangeElements()

Pobiera wszystkie elementy w tym elemencie typu Range, w tym częściowe elementy Text (na przykład w przypadku argumentu takiego, który zawiera tylko część elementu Text). Aby ustalić, czy Element Text jest tylko częściowo uwzględniony w zakresie, patrz RangeElement.isPartial().

Powrót

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

Autoryzacja

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. Nazwa została zmieniona na getRangeElements().

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

Powrót

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

Autoryzacja

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