Wrapper di sekitar Element dengan kemungkinan offset awal dan akhir. Offset ini memungkinkan rentang karakter dalam elemen Text
direpresentasikan dalam hasil penelusuran, pilihan dokumen, dan rentang bernama.
Metode
| Metode | Jenis nilai yang ditampilkan | Deskripsi singkat |
|---|---|---|
get | Element | Mendapatkan Element yang sesuai dengan Range ini. |
get | Integer | Mendapatkan posisi akhir rentang parsial dalam elemen rentang. |
get | Integer | Mendapatkan posisi awal rentang parsial dalam elemen rentang. |
is | Boolean | Menentukan apakah elemen rentang ini mencakup seluruh elemen atau sebagian pilihan karakter elemen. |
Dokumentasi mendetail
getElement()
Mendapatkan Element yang sesuai dengan RangeElement ini.
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.'); }
Pulang pergi
Element — elemen yang sesuai dengan RangeElement ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getEndOffsetInclusive()
Mendapatkan posisi akhir rentang parsial dalam elemen rentang. Jika elemen adalah elemen
Text dan isPartial() menampilkan true, offset adalah jumlah karakter sebelum karakter
terakhir dalam rentang (yaitu, indeks karakter terakhir dalam rentang); dalam kasus
lain, metode ini menampilkan -1.
Pulang pergi
Integer — untuk elemen Text, jumlah karakter sebelum karakter terakhir dalam rentang; untuk elemen lain, -1
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getStartOffset()
Mendapatkan posisi awal rentang parsial dalam elemen rentang. Jika elemen adalah elemen Text dan isPartial() menampilkan true, offset adalah jumlah karakter sebelum awal rentang (yaitu, indeks karakter pertama dalam rentang); dalam kasus lain, metode ini menampilkan -1.
Pulang pergi
Integer — untuk elemen Text, jumlah karakter sebelum awal rentang; untuk elemen lain, -1
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
isPartial()
Menentukan apakah elemen rentang ini mencakup seluruh elemen atau sebagian pilihan karakter elemen. Awal dan akhir rentang elemen rentang parsial dapat ditentukan menggunakan getStartOffset() dan getEndOffsetInclusive().
Pulang pergi
Boolean — true jika elemen disertakan sebagian; false jika tidak
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents