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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
get | Element | Pobiera element Element odpowiadający temu elementowi Range . |
get | Integer | Pobiera pozycję końca częściowego zakresu w elemencie zakresu. |
get | Integer | Pobiera pozycję początku częściowego zakresu w elemencie zakresu. |
is | Boolean | Określa, czy ten element zakresu obejmuje cały element czy tylko częściową jego część. |
Szczegółowa dokumentacja
get Element()
Pobiera element Element
odpowiadający temu elementowi Range
.
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 Range
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
get End Offset Inclusive()
Pobiera pozycję końca częściowego zakresu w elemencie zakresu. Jeśli element jest elementem Text
, a funkcja is
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
get Start Offset()
Pobiera pozycję początku częściowego zakresu w elemencie zakresu. Jeśli element jest elementem Text
, a is
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
is Partial()
Określa, czy ten element zakresu obejmuje cały element czy tylko częściową jego część. Początek i koniec zakresu elementu częściowego zakresu można określić odpowiednio za pomocą get
i get
.
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