Pilihan adalah apa pun yang saat ini dipilih di halaman presentasi terbuka, seperti rentang teks yang ditandai atau tabel. Panduan ini memberi tahu Anda cara mendapatkan dan menetapkan pilihan dalam presentasi aktif menggunakan Apps Script.
Pemilihan adalah snapshot saat skrip dimulai. Jika pengguna mengklik dan pilihan berubah saat skrip berjalan, perubahan tersebut tidak akan diterapkan.
Pilihan dan jenis pemilihan
Anda dapat membaca pilihan menggunakan class Pilihan. Class ini memiliki berbagai metode untuk mendapatkan objek yang dipilih berdasarkan jenis objek yang dipilih.
Enum SelectionType
mewakili jenis tertentu objek yang dipilih. Misalnya, jika pengguna telah
memilih beberapa teks dalam sebuah bentuk, jenis pemilihannya akan
menjadi TEKS. Dalam hal ini, Anda dapat mengambil rentang teks yang dipilih menggunakan
metode selection.getTextRange()
.
Anda juga dapat mengambil objek yang berisi pilihan. Dengan melanjutkan
contoh di atas, Anda dapat mengambil bentuk yang berisi teks yang dipilih menggunakan
selection.getPageElementRange().getPageElements()[0]
. Demikian pula, halaman yang
berisi bentuk pembatas adalah halaman aktif saat ini. Untuk
mengambil halaman tersebut, gunakan selection.getCurrentPage()
.
Membaca pilihan
Untuk membaca pilihan, gunakan metode Presentation.getSelection() seperti yang ditunjukkan dalam contoh berikut:
Membaca halaman saat ini
Untuk mengambil Page saat ini yang sedang dilihat pengguna, gunakan metode getSelection() dan getCurrentPage() sebagai berikut:
Perhatikan bahwa halaman saat ini dapat berupa salah satu jenis berikut:
Halaman saat ini dapat memiliki satu atau beberapa objek yang dipilih, dan SelectionType menentukan jenis pemilihan.
Membaca pilihan berdasarkan jenis pilihan
Contoh berikut menunjukkan cara menggunakan jenis pemilihan untuk membaca pilihan saat ini dengan cara yang sesuai jenisnya.
Membaca pilihan teks
Anda dapat membaca pemilihan teks menggunakan metode Selection.getTextRange(). Ada dua jenis pemilihan teks:
- Pemilihan rentang: Jika bentuk berisi teks "Halo", dan "He" dipilih, rentang yang ditampilkan memiliki startIndex=0, dan endIndex=2.
- Pemilihan kursor: Jika bentuk berisi teks "Hello", dan kursor diletakkan setelah "H" ("H|ello"), rentang yang ditampilkan adalah rentang kosong dengan startIndex=1 dan endIndex=1.
Memodifikasi pilihan
Skrip dapat mengubah pilihan pengguna. Setiap perubahan pemilihan yang dibuat skrip pada presentasi akan tercermin dalam operasi pemilihan berikutnya selama durasi eksekusi skrip.
Perubahan pemilihan akan tercermin di browser pengguna hanya setelah eksekusi skrip selesai, atau saat Presentation.saveAndClose()
dipanggil.
Memilih halaman saat ini
Halaman dalam presentasi aktif dapat dipilih sebagai halaman saat ini dengan memanggil metode selectAsCurrentPage(). Metode ini menghapus elemen halaman, halaman, atau pemilihan teks sebelumnya. Jadi, penggunaan metode ini di halaman saat ini memungkinkan Anda membatalkan pilihan pilihan saat ini di halaman. Contoh:
Memilih elemen halaman
Untuk memilih elemen halaman di halaman, gunakan metode PageElement.select(). Tindakan ini juga membatalkan pilihan elemen halaman yang dipilih sebelumnya.
Contoh:
Memilih beberapa elemen halaman
Untuk menambahkan elemen halaman tambahan ke pilihan, gunakan metode PageElement.select(false). Semua elemen halaman harus berada di halaman saat ini.
Mengubah pilihan
Pengeditan yang dijalankan skrip Anda dapat mengubah pilihan saat ini, sehingga apa yang dipilih berubah sebagai hasil dari pengeditan tersebut. Contoh:
- Misalnya Anda telah memilih dua bentuk A dan B.
- Selanjutnya skrip Anda menghapus bentuk A.
- Akibatnya, pilihan ditransformasikan terhadap edit sehingga hanya bentuk B yang dipilih.
Contoh berikut menunjukkan cara mengubah pilihan dengan memanipulasi elemen halaman yang dipilih.
Memilih teks
Teks yang dimuat dalam bentuk atau dalam sel tabel dapat dipilih menggunakan metode TextRange.select(). Jika teks dimuat dalam sebuah bentuk, maka bentuk itu juga akan dipilih. Jika teks dimuat dalam sel tabel, sel tabel tersebut dan tabel penutupnya akan dipilih.
Tindakan ini juga menetapkan halaman induk sebagai halaman saat ini.
Pilihan rentang dalam bentuk
Contoh berikut menunjukkan cara membuat pilihan rentang dalam teks yang dimuat dalam sebuah bentuk.
Pemilihan kursor dalam sebuah bentuk
Contoh berikut menunjukkan cara membuat pemilihan kursor dalam teks yang dimuat dalam sebuah bentuk.
Pemilihan rentang dalam sel tabel
Contoh berikut menunjukkan cara membuat pilihan rentang dalam teks yang dimuat dalam sel tabel.
Pemilihan kursor di TableCell
Contoh berikut menunjukkan cara membuat pilihan kursor dalam teks yang dimuat dalam sel tabel.
Transformasi pemilihan dengan pengeditan tekstual
Contoh berikut menunjukkan cara mengubah pilihan dengan mengedit teks yang dipilih.
Membatalkan pilihan
Tidak ada metode eksplisit untuk membatalkan pilihan teks atau elemen halaman. Namun, hasil ini dapat dicapai menggunakan metode Page.selectAsCurrentPage()
atau pageElement.select()
.
Pilih halaman saat ini
Contoh berikut menunjukkan cara membatalkan pilihan pada pilihan saat ini di halaman dengan menetapkan halaman tersebut sebagai halaman saat ini.
Pilih elemen halaman
Contoh berikut menunjukkan cara membatalkan pilihan pilihan saat ini di halaman dengan memilih satu elemen halaman, sehingga menghapus semua item lain dari pilihan.