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 active tab.
var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.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 sebagian ke RangeBuilder ini.
addElementsBetween(startElement, endElementInclusive)	RangeBuilder	Menambahkan dua elemen utuh, dan semua elemen di antaranya, ke RangeBuilder ini.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)	RangeBuilder	Menambahkan dua elemen Text parsial, dan semua elemen di antara mereka, ke RangeBuilder.
addRange(range)	RangeBuilder	Menambahkan konten Range lain ke RangeBuilder ini.
build()	Range	Membuat Range dari setelan yang diterapkan pada builder.
getRangeElements()	RangeElement[]	Mendapatkan semua elemen dalam Range ini, termasuk elemen Text parsial (misalnya, dalam kasus dari pilihan yang hanya menyertakan sebagian dari 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 terbuka dokumen, termasuk Text yang dipilih sebagian yang kurang penting.

Dokumentasi mendetail

addElement(element)

Menambahkan seluruh Element ke RangeBuilder ini.

Parameter

Nama	Jenis	Deskripsi
element	Element	elemen yang akan ditambahkan

Pulang pergi

RangeBuilder — builder ini, untuk perantaian

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 sebagian ke RangeBuilder ini.

Parameter

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

Pulang pergi

RangeBuilder — builder ini, untuk perantaian

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

Pulang pergi

RangeBuilder — builder ini, untuk perantaian

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 antara mereka, 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)

Pulang pergi

RangeBuilder — builder ini, untuk perantaian

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

Pulang pergi

RangeBuilder — builder ini, untuk perantaian

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 pada builder.

Pulang pergi

Range — rentang yang baru dibuat

---

getRangeElements()

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

Pulang pergi

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 terbuka dokumen, termasuk Text yang dipilih sebagian yang kurang penting.

Pulang pergi

RangeElement[] — array elemen yang dipilih atau dipilih sebagian, sesuai urutan kemunculannya di 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