Class RangeBuilder

RangeBuilder

Builder yang digunakan untuk membuat objek Range dari elemen dokumen.

// Change the user's selection to a range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
addElement(element)	RangeBuilder	Menambahkan seluruh Element ke RangeBuilder ini.
addElement(textElement, startOffset, endOffsetInclusive)	RangeBuilder	Menambahkan elemen Text parsial ke RangeBuilder ini.
addElementsBetween(startElement, endElementInclusive)	RangeBuilder	Menambahkan dua elemen keseluruhan, dan semua elemen di antaranya, ke RangeBuilder ini.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)	RangeBuilder	Menambahkan dua elemen Text parsial, dan semua elemen di antaranya, ke RangeBuilder.
addRange(range)	RangeBuilder	Menambahkan konten Range lain ke RangeBuilder ini.
build()	Range	Membuat Range dari setelan yang diterapkan ke builder.
getRangeElements()	RangeElement[]	Mendapatkan semua elemen dalam Range ini, termasuk elemen Text sebagian (misalnya, dalam kasus pilihan yang hanya menyertakan sebagian elemen Text).

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
getSelectedElements()	RangeElement[]	Mendapatkan semua elemen yang telah dipilih pengguna dalam instance dokumen yang terbuka, termasuk elemen Text yang dipilih sebagian.

Dokumentasi mendetail

addElement(element)

Menambahkan seluruh Element ke RangeBuilder ini.

Parameter

Nama	Jenis	Deskripsi
element	Element	elemen yang akan ditambahkan

Return

RangeBuilder — builder ini, untuk membuat rantai

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

---

addElement(textElement, startOffset, endOffsetInclusive)

Menambahkan elemen Text parsial ke RangeBuilder ini.

Parameter

Nama	Jenis	Deskripsi
textElement	Text	elemen teks yang akan ditambahkan sebagian
startOffset	Integer	jumlah karakter sebelum karakter pertama yang disertakan (yaitu, indeks karakter pertama dalam rentang)
endOffsetInclusive	Integer	jumlah karakter sebelum karakter terakhir yang akan disertakan (yaitu, indeks karakter terakhir dalam rentang)

Return

RangeBuilder — builder ini, untuk membuat rantai

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

---

addElementsBetween(startElement, endElementInclusive)

Menambahkan dua elemen keseluruhan, dan semua elemen di antaranya, ke RangeBuilder ini.

Parameter

Nama	Jenis	Deskripsi
startElement	Element	elemen pertama yang akan ditambahkan
endElementInclusive	Element	elemen terakhir yang akan ditambahkan

Return

RangeBuilder — builder ini, untuk membuat rantai

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

---

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

Menambahkan dua elemen Text parsial, dan semua elemen di antaranya, ke RangeBuilder.

Parameter

Nama	Jenis	Deskripsi
startTextElement	Text	elemen teks pertama yang ditambahkan sebagian
startOffset	Integer	jumlah karakter sebelum karakter pertama startTextElement yang akan disertakan (yaitu, indeks karakter pertama dalam rentang)
endTextElementInclusive	Text	elemen teks terakhir yang ditambahkan sebagian
endOffsetInclusive	Integer	jumlah karakter sebelum karakter terakhir endTextElementInclusive yang akan disertakan (yaitu, indeks karakter terakhir dalam rentang)

Return

RangeBuilder — builder ini, untuk membuat rantai

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

---

addRange(range)

Menambahkan konten Range lain ke RangeBuilder ini.

Parameter

Nama	Jenis	Deskripsi
range	Range	rentang yang elemennya harus ditambahkan

Return

RangeBuilder — builder ini, untuk membuat rantai

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

---

build()

Membuat Range dari setelan yang diterapkan ke builder.

Return

Range — rentang yang baru dibuat

---

getRangeElements()

Mendapatkan semua elemen dalam Range ini, termasuk elemen Text sebagian (misalnya, dalam kasus pilihan yang hanya menyertakan sebagian elemen Text). Untuk menentukan apakah elemen Text hanya disertakan sebagian dalam rentang, lihat RangeElement.isPartial().

Return

RangeElement[] — array elemen, sesuai urutan kemunculannya dalam dokumen

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

Metode yang tidak digunakan lagi

getSelectedElements()

Tidak digunakan lagi. Mengganti namanya menjadi getRangeElements().

Mendapatkan semua elemen yang telah dipilih pengguna dalam instance dokumen yang terbuka, termasuk elemen Text yang dipilih sebagian.

Return

RangeElement[] — array elemen yang dipilih atau dipilih sebagian, sesuai urutan kemunculannya dalam dokumen

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