Halaman ini diterjemahkan oleh Cloud Translation API.

Class 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 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 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` parsial (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

Pulang pergi

RangeBuilder — builder ini, untuk pembuatan 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 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 pembuatan 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 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 pembuatan 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 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 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 pembuatan 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

Pulang pergi

RangeBuilder — builder ini, untuk pembuatan 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.

Pulang pergi

Range — rentang yang baru dibuat

`getRangeElements()`

Mendapatkan semua elemen dalam Range ini, termasuk elemen Text parsial (misalnya, dalam kasus pilihan yang hanya menyertakan sebagian elemen Text). Untuk menentukan apakah elemen Text hanya sebagian disertakan 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 dokumen yang terbuka, termasuk elemen Text yang dipilih sebagian.

Pulang pergi

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