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