Class RangeElement

ElemenRentang

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getElement()ElementMendapatkan Element yang sesuai dengan RangeElement ini.
getEndOffsetInclusive()IntegerMendapatkan posisi akhir rentang sebagian dalam elemen rentang.
getStartOffset()IntegerMendapatkan posisi awal rentang parsial dalam elemen rentang.
isPartial()BooleanMenentukan 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 sebagian 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 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

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 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

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

Booleantrue 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