Class RangeBuilder

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Kreator kompilacji

Kreator służący do tworzenia obiektów Range na podstawie elementów dokumentów.

// 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

MetodaZwracany typKrótki opis
addElement(element)RangeBuilderDodaje całe Element do tego RangeBuilder.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilderDodaje częściowy element Text do tego elementu: RangeBuilder.
addElementsBetween(startElement, endElementInclusive)RangeBuilderDodaje dwa całe elementy i wszystkie elementy między nimi, aby RangeBuilder.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilderDodaje 2 częściowe elementy Text i wszystkie te elementy do elementu RangeBuilder.
addRange(range)RangeBuilderDodaje zawartość innego elementu Range do tego elementu RangeBuilder.
build()RangePowoduje utworzenie Range na podstawie ustawień zastosowanych w kreatorze.
getRangeElements()RangeElement[]Pobiera wszystkie elementy tego elementu Range, w tym wszystkie częściowe elementy Text (np. w przypadku zaznaczenia, które zawiera tylko część elementu Text).

Szczegółowa dokumentacja

addElement(element)

Dodaje całe Element do tego RangeBuilder.

Parametry

NazwaTypOpis
elementElementelement do dodania

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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, który ma zostać dodany częściowo
startOffsetIntegerliczbę znaków przed pierwszym znakiem do uwzględnienia (czyli indeks pierwszego znaku w zakresie)
endOffsetInclusiveIntegerliczbę znaków przed ostatnim znakiem do uwzględnienia (czyli indeks ostatniego znaku w zakresie)

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addElementsBetween(startElement, endElementInclusive)

Dodaje dwa całe elementy i wszystkie elementy między nimi, aby RangeBuilder.

Parametry

NazwaTypOpis
startElementElementpierwszy element do dodania
endElementInclusiveElementostatni element do dodania

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 te elementy do elementu RangeBuilder.

Parametry

NazwaTypOpis
startTextElementTextpierwszy element tekstowy, który zostanie dodany częściowo
startOffsetIntegerliczbę znaków przed pierwszym znakiem uwzględnionym w kolumnie startTextElement (czyli indeks pierwszego znaku w zakresie)
endTextElementInclusiveTextostatni element tekstowy do dodania;
endOffsetInclusiveIntegerliczba znaków przed ostatnim znakiem uwzględnionym w kolumnie endTextElementInclusive (czyli indeks ostatniego znaku w zakresie)

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 należy dodać

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

build()

Powoduje utworzenie Range na podstawie ustawień zastosowanych w kreatorze.

Zwróć

Range – nowo utworzony zakres


getRangeElements()

Pobiera wszystkie elementy tego elementu Range, w tym wszystkie częściowe elementy Text (np. w przypadku zaznaczenia, które zawiera tylko część elementu Text). Aby określić, czy element Text znajduje się tylko w zakresie, przejdź do sekcji RangeElement.isPartial().

Zwróć

RangeElement[] – tablica elementów w takiej kolejności, w jakiej pojawiają się w dokumencie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

Wycofane metody