Class RangeBuilder

RangeBuilder

Konstruktor 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

MetodaZwracany typKrótki opis
addElement(element)RangeBuilderDodaje cały Element do tego 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 elementu 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 przypadku narzędzia do tworzenia.
getRangeElements()RangeElement[]Pobiera wszystkie elementy w tym obiekcie Range, w tym wszystkie częściowe elementy Text (np. w przypadku zaznaczenia, które obejmuje tylko część elementu Text).

Szczegółowa dokumentacja

addElement(element)

Dodaje cały Element do tego RangeBuilder.

Parametry

NazwaTypOpis
elementElementelement do dodania,

Powrót

RangeBuilder – ten konstruktor do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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ć częściowo dodany;
startOffsetIntegerliczba znaków przed pierwszym znakiem, który ma zostać uwzględniony (czyli indeks pierwszego znaku w zakresie);
endOffsetInclusiveIntegerliczba znaków przed ostatnim znakiem, który ma zostać uwzględniony (czyli indeks ostatniego znaku w zakresie);

Powrót

RangeBuilder – ten konstruktor do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 dodany element.

Powrót

RangeBuilder – ten konstruktor do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 do elementu RangeBuilder 2 częściowe elementy Text i wszystkie elementy między nimi.

Parametry

NazwaTypOpis
startTextElementTextpierwszy element tekstowy, który ma zostać częściowo dodany;
startOffsetIntegerliczba znaków przed pierwszym znakiem startTextElement, które mają zostać uwzględnione (czyli indeks pierwszego znaku w zakresie);
endTextElementInclusiveTextostatni element tekstowy, który został częściowo dodany.
endOffsetInclusiveIntegerliczba znaków przed ostatnim znakiem argumentu endTextElementInclusive, które mają zostać uwzględnione (czyli indeks ostatniego znaku w zakresie).

Powrót

RangeBuilder – ten konstruktor do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 mają zostać dodane;

Powrót

RangeBuilder – ten konstruktor do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 przypadku narzędzia do tworzenia.

Powrót

Range – nowo utworzony zakres;

getRangeElements()

Pobiera wszystkie elementy w tym obiekcie Range, w tym wszystkie częściowe elementy Text (np. w przypadku zaznaczenia, które obejmuje tylko część elementu Text). Aby sprawdzić, czy element Text jest tylko częściowo uwzględniony w zakresie, zobacz 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 użyciem co najmniej jednego z tych zakresów:

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

Wycofane metody