Class RangeElement

RangeElement

Obiekt opakowujący Element z możliwym przesunięciem początku i końca. Te przesunięcia umożliwiają reprezentowanie w wynikach wyszukiwania, wyborach dokumentów i nazwanych zakresach zakresu znaków w elemencie Text.

Metody

MetodaZwracany typKrótki opis
getElement()ElementPobiera Element odpowiadający temu RangeElement.
getEndOffsetInclusive()IntegerPobiera pozycję końca zakresu częściowego w elemencie zakresu.
getStartOffset()IntegerPobiera pozycję początku zakresu częściowego w elemencie zakresu.
isPartial()BooleanOkreśla, czy ten element zakresu obejmuje cały element, czy tylko częściowy wybór znaków elementu.

Szczegółowa dokumentacja

getElement()

Pobiera Element odpowiadający temu RangeElement. 

const rangeElement = DocumentApp.getActiveDocument().getSelection().getRangeElements()[0];

// Log debug information about a range element.
Logger.log(`Element type: ${rangeElement.getElement().getType()}`);
if (rangeElement.isPartial()) {
  Logger.log(`The character range begins at ${rangeElement.getStartOffset()}`);
  Logger.log(
      `The character range ends at ${rangeElement.getEndOffsetInclusive()}`,
  );
} else {
  Logger.log('The entire range element is included.');
}

Powrót

Element – element odpowiadający temu RangeElement.

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

getEndOffsetInclusive()

Pobiera pozycję końca zakresu częściowego w elemencie zakresu. Jeśli element jest elementem Text, a isPartial() zwraca true, przesunięcie jest liczbą znaków przed ostatnim znakiem w zakresie (czyli indeksem ostatniego znaku w zakresie); w każdym innym przypadku ta metoda zwraca -1.

Powrót

Integer – w przypadku elementów Text liczba znaków przed ostatnim znakiem w zakresie; w przypadku innych elementów -1

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

getStartOffset()

Pobiera pozycję początku zakresu częściowego w elemencie zakresu. Jeśli element jest elementem Text, a isPartial() zwraca true, przesunięcie jest liczbą znaków przed początkiem zakresu (czyli indeksem pierwszego znaku w zakresie); w każdym innym przypadku ta metoda zwraca -1.

Powrót

Integer – w przypadku Text elementów liczba znaków przed początkiem zakresu; w przypadku innych elementów -1

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

isPartial()

Określa, czy ten element zakresu obejmuje cały element, czy tylko częściowy wybór znaków elementu. Początek i koniec zakresu elementu zakresu częściowego można określić za pomocą odpowiednio znaków getStartOffset() i getEndOffsetInclusive().

Powrót

Boolean – true, jeśli element jest częściowo uwzględniony; false, jeśli nie jest

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