Bagikan melalui

Menerapkan Pola Kontrol Pemilihan Automasi UI

Nota

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas Automation UI terkelola yang ditentukan dalam namespace System.Windows.Automation. Untuk informasi terbaru tentang Automasi UI, lihat Windows Automation API: UI Automation.

Topik ini memperkenalkan panduan dan konvensi untuk menerapkan ISelectionProvider, termasuk informasi tentang peristiwa dan properti. Tautan ke referensi tambahan tercantum di akhir topik.

Pola SelectionPattern kontrol 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 menerapkan pola kontrol ini, lihat Pemetaan Pola Kontrol untuk Klien Automasi UI.

Pedoman dan Konvensi Implementasi

Saat menerapkan pola kontrol Pilihan, perhatikan panduan dan konvensi berikut:

  • Kontrol yang mengimplementasikan ISelectionProvider memungkinkan pemilihan item anak tunggal maupun ganda. Misalnya, kotak daftar, tampilan daftar, dan tampilan pohon mendukung beberapa pilihan sedangkan kotak kombo, slider, dan grup tombol radio mendukung pilihan tunggal.

  • Kontrol yang memiliki rentang minimum, maksimum, dan berkelanjutan, seperti kontrol penggerak Volume , harus diterapkan IRangeValueProvider alih-alih ISelectionProvider.

  • Kontrol pilihan tunggal yang mengelola kontrol anak yang mengimplementasikan IRawElementProviderFragmentRoot, seperti penggeser Resolusi Layar dalam kotak dialog Properti Tampilan atau kontrol pemilihan Pemilih Warna dari Microsoft Word (diilustrasikan di bawah), harus mengimplementasikan ; anak-anak mereka harus mengimplementasikan ISelectionProviderdan IRawElementProviderFragmentISelectionItemProvider.

Pemilih warna dengan sorotan warna kuning. Contoh Pemetaan String Sampel Warna

  • Menu tidak mendukung SelectionPattern. 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 ISelectionProvider antarmuka.

Anggota yang diperlukan Tipe Catatan
CanSelectMultiple Harta benda Harus mendukung properti mengubah peristiwa menggunakan AddAutomationPropertyChangedEventHandler dan RemoveAutomationPropertyChangedEventHandler.
IsSelectionRequired Harta benda Harus mendukung properti mengubah peristiwa menggunakan AddAutomationPropertyChangedEventHandler dan RemoveAutomationPropertyChangedEventHandler.
GetSelection Metode Tidak ada
InvalidatedEvent Peristiwa Dimunculkan ketika pilihan dalam kontainer telah berubah secara signifikan dan memerlukan pengiriman lebih banyak acara penambahan dan penghapusan daripada batasan konstanta InvalidateLimit.

Properti IsSelectionRequired dan CanSelectMultiple bisa dinamis. Misalnya, status awal kontrol mungkin tidak memiliki item apa pun yang dipilih secara default, 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 satu pilihan untuk dibuat.

Pengecualian

Penyedia harus memberikan pengecualian berikut.

Tipe Pengecualian Keadaan
ElementNotEnabledException Jika kontrol tidak diaktifkan.
InvalidOperationException Jika kontrol disembunyikan.

Lihat juga

  • Last updated on