Rentang elemen dalam dokumen. Pilihan pengguna direpresentasikan sebagai Range
, di antara
penggunaan lainnya. Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya
jika skrip terikat ke dokumen.
// Bold all selected text. var selection = DocumentApp.getActiveDocument().getSelection(); if (selection) { var elements = selection.getRangeElements(); for (var i = 0; i < elements.length; i++) { var element = elements[i]; // Only modify elements that can be edited as text; skip images and other non-text elements. if (element.getElement().editAsText) { var text = element.getElement().editAsText(); // Bold the selected part of the element, or the full element if it's completely selected. if (element.isPartial()) { text.setBold(element.getStartOffset(), element.getEndOffsetInclusive(), true); } else { text.setBold(true); } } } }
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
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
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 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