Wrapper di sekitar Element
dengan kemungkinan offset awal dan akhir. Offset ini memungkinkan
rentang karakter dalam elemen Text
ditampilkan dalam hasil penelusuran, pilihan dokumen, dan rentang bernama.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
get | Element | Mendapatkan Element yang sesuai dengan Range ini. |
get | Integer | Mendapatkan posisi akhir rentang sebagian 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
get Element()
Mendapatkan Element
yang sesuai dengan Range
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 Range
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
get End Offset Inclusive()
Mendapatkan posisi akhir rentang sebagian dalam elemen rentang. Jika elemen adalah elemen Text
dan is
menampilkan true
, offset adalah jumlah karakter sebelum karakter terakhir dalam rentang (yaitu, indeks karakter terakhir dalam rentang); dalam kasus lain, metode ini akan 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
get Start Offset()
Mendapatkan posisi awal rentang parsial dalam elemen rentang. Jika elemen adalah elemen Text
dan is
menampilkan true
, offset adalah jumlah karakter sebelum awal rentang (yaitu, indeks karakter pertama dalam rentang); dalam kasus lain, metode ini akan 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
is Partial()
Menentukan apakah elemen rentang ini mencakup seluruh elemen atau sebagian pilihan
karakter elemen. Awal dan akhir rentang elemen rentang parsial dapat ditentukan menggunakan get
dan get
.
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