Pola Kontrol Pemilihan
Menjelaskan panduan dan konvensi untuk menerapkan ISelectionProvider, termasuk informasi tentang properti, metode, dan peristiwa. Pola kontrol Pilihan digunakan untuk mendukung kontrol yang bertindak sebagai kontainer untuk kumpulan item anak yang dapat dipilih. Anak-anak dari elemen ini harus mengimplementasikan ISelectionItemProvider.
Untuk contoh kontrol yang mengimplementasikan pola kontrol ini, lihat Jenis Kontrol dan Pola Kontrol yang Didukung.
Topik ini berisi bagian berikut.
Panduan dan Konvensi Implementasi
Saat menerapkan pola kontrol Seleksi , perhatikan pedoman dan konvensi berikut:
Kontrol yang mengimplementasikan ISelectionProvider memungkinkan item anak tunggal atau beberapa dipilih. Misalnya, kotak daftar, tampilan daftar, dan tampilan pohon mendukung beberapa pilihan, sedangkan kotak kombo, penggeser, dan grup tombol radio mendukung pilihan tunggal.
Kontrol yang memiliki rentang minimum, maksimum, dan berkelanjutan, seperti kontrol penggiser Volume pemutar media, harus mengimplementasikan IRangeValueProvider alih-alih ISelectionProvider.
Kontrol pilihan tunggal yang mengelola kontrol anak yang mengimplementasikan IRawElementProviderFragmentRoot, seperti penggeser Resolusi Layar dalam dialog Properti Tampilan untuk Windows, atau kontrol pilihan Pemilih Warna dari Microsoft Word (lihat gambar berikut), harus menerapkan ISelectionProvider; anak-anak mereka harus menerapkan IRawElementProviderFragment dan ISelectionItemProvider.
Menu tidak mendukung pola kontrol Pilihan . Jika Anda bekerja dengan item menu yang menyertakan grafik dan teks (seperti item Panel Pratinjau di menu Tampilan di Microsoft Outlook) dan perlu menyampaikan status, Anda harus menerapkan IToggleProvider.
Anggota yang Diperlukan untuk ISelectionProvider
Properti, metode, dan peristiwa berikut diperlukan untuk mengimplementasikan antarmuka ISelectionProvider .
| Anggota yang diperlukan | Jenis anggota | Catatan |
|---|---|---|
| CanSelectMultiple | Properti | Tidak ada |
| IsSelectionRequired | Properti | Tidak ada |
| GetSelection | Metode | Tidak ada |
| UIA_Selection_InvalidatedEventId | Kejadian | Naikkan peristiwa ini ketika pilihan dalam kontainer telah berubah secara signifikan. |
Properti ISelectionProvider::IsSelectionRequired dan CanSelectMultiple dapat bersifat dinamis. Misalnya, status awal kontrol mungkin tidak memiliki item apa pun yang dipilih secara default, yang menunjukkan bahwa IsSelectionRequired adalah false. Namun, setelah item dipilih, kontrol harus selalu memiliki setidaknya satu item yang dipilih. Demikian pula, dalam kasus yang jarang terjadi, kontrol mungkin memungkinkan beberapa item dipilih pada inisialisasi, tetapi kemudian hanya mengizinkan pilihan tunggal yang akan dibuat.
Topik terkait