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.
const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Metode

Metode	Jenis nilai 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 secara 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	Membangun Range dari setelan yang diterapkan ke builder.
getRangeElements()	RangeElement[]	Mendapatkan semua elemen dalam Range ini, termasuk elemen Text parsial (misalnya, dalam kasus pemilihan yang hanya menyertakan sebagian elemen Text).

Metode yang tidak digunakan lagi

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

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 dirangkaikan

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

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

Pulang pergi

RangeBuilder — builder ini, untuk dirangkaikan

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

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 dirangkaikan

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

Membangun Range dari setelan yang diterapkan ke builder.

Pulang pergi

Range — rentang yang baru dibuat

---

getRangeElements()

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

Pulang pergi

RangeElement[] — array elemen, dalam 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 yang dipilih sebagian.Text

Pulang pergi

RangeElement[] — array elemen yang dipilih atau sebagian dipilih, dalam 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