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