Class RangeElement

ElementZakres

Otoczka dla Element z możliwym przesunięciem początkowym i końcowym. Te przesunięcia umożliwiają reprezentowanie zakresu znaków w elemencie Text w wynikach wyszukiwania, wyborach dokumentu i zakresach nazwanych.

Metody

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

Szczegółowa dokumentacja

getElement()

Pobiera element Element odpowiadający temu elementowi 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, które korzystają 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

getEndOffsetInclusive()

Pobiera pozycję końca częściowego zakresu w elemencie zakresu. Jeśli element jest elementem Text, a funkcja isPartial() zwraca true, przesunięcie to liczba znaków przed ostatnim znakiem w zakresie (czyli indeks ostatniego znaku w zakresie); w innym przypadku 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, które korzystają 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

getStartOffset()

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

Powrót

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

Autoryzacja

Skrypty, które korzystają 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

isPartial()

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

Powrót

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

Autoryzacja

Skrypty, które korzystają 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