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

MetodaZwracany typKrótki opis
addElement(element)RangeBuilderDodaje cały element Element do elementu RangeBuilder.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilderDodaje częściowy element Text do tego elementu (RangeBuilder).
addElementsBetween(startElement, endElementInclusive)RangeBuilderDodaje do tego elementu RangeBuilder 2 całe elementy i wszystkie elementy między nimi.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilderDodaje do pola RangeBuilder 2 częściowe elementy Text i wszystkie elementy między nimi.
addRange(range)RangeBuilderDodaje zawartość innego elementu Range do tego elementu (RangeBuilder).
build()RangeTworzy 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).

Szczegółowa dokumentacja

addElement(element)

Dodaje cały element Element do elementu RangeBuilder.

Parametry

NazwaTypOpis
elementElementelement, 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

NazwaTypOpis
textElementTextelement tekstowy do częściowego dodania
startOffsetIntegerliczbę znaków przed pierwszym uwzględnionym znakiem (tzn. indeks pierwszego znaku w zakresie)
endOffsetInclusiveIntegerliczbę 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

NazwaTypOpis
startElementElementpierwszy element do dodania
endElementInclusiveElementostatni 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

NazwaTypOpis
startTextElementTextpierwszy element tekstowy do częściowego dodania
startOffsetIntegerliczba znaków przed pierwszym znakiem z startTextElement do uwzględnienia (czyli indeks pierwszego znaku w zakresie)
endTextElementInclusiveTextostatni element tekstowy do częściowego dodania
endOffsetInclusiveIntegerliczbę 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

NazwaTypOpis
rangeRangezakres, 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