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