Otoka wokół elementu Element z możliwym przesunięciem początku i końca. Te przesunięcia umożliwiają odzwierciedlenie zakresu znaków w elemencie Text w wynikach wyszukiwania, wyborze dokumentów i zakresach nazwanych.
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
getElement() | Element | Pobiera element Element odpowiadający obiektowi RangeElement. |
getEndOffsetInclusive() | Integer | Pobiera pozycję końca częściowego zakresu w elemencie zakresu. |
getStartOffset() | Integer | Pobiera pozycję początku częściowego zakresu w elemencie zakresu. |
isPartial() | Boolean | Określa, czy ten element zakresu obejmuje cały element, czy tylko część jego znaków. |
Szczegółowa dokumentacja
getElement()
Pobiera element Element odpowiadający obiektowi RangeElement.
// 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.');
}
Powroty
Element – element odpowiadający obiektowi RangeElement,
Upoważnienie
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
getEndOffsetInclusive()
Pobiera pozycję końca częściowego zakresu w elemencie zakresu. Jeśli element jest elementem Text, a isPartial() zwraca wartość true, przesunięcie to liczba znaków przed ostatnim znakiem w zakresie (czyli indeksem ostatniego znaku w zakresie). W każdym innym przypadku ta metoda zwraca -1.
Powroty
Integer – w przypadku elementów Text liczba znaków przed ostatnim znakiem w zakresie; w przypadku innych elementów – -1
Upoważnienie
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
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 poprzedzających początek zakresu (czyli indeks pierwszego znaku w zakresie). W każdym innym przypadku ta metoda zwraca -1.
Powroty
Integer – w przypadku elementów Text liczba znaków poprzedzających początek zakresu, a w przypadku pozostałych elementów – -1.
Upoważnienie
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
isPartial()
Określa, czy ten element zakresu obejmuje cały element, czy tylko część jego znaków. Początek i koniec zakresu elementu częściowego zakresu można określić odpowiednio za pomocą getStartOffset() i getEndOffsetInclusive().
Powroty
Boolean – true, jeśli element jest uwzględniony częściowo; jeśli nie jest to element: false
Upoważnienie
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