Menerapkan Pola Kontrol SelectionItem UI Automation
Catatan
Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas UI Automation terkelola yang ditentukan pada namespace System.Windows.Automation. Untuk informasi terbaru tentang UI Automation, lihat API Automasi Windows: Automasi Antarmuka Pengguna.
Topik ini memperkenalkan pedoman dan konvensi untuk menerapkan ISelectionItemProvider, termasuk informasi tentang properti, metode, dan peristiwa. Link ke referensi tambahan tercantum di akhir gambaran umum.
Pola SelectionItemPattern kontrol digunakan untuk mendukung kontrol yang bertindak sebagai item turunan individual yang dapat dipilih dari kontrol kontainer yang mengimplementasikan ISelectionProvider. Untuk contoh kontrol yang menerapkan pola kontrol SelectionItem, lihat Pemetaan Pola Kontrol untuk Klien UI Automation
Pedoman dan Konvensi Implementasi
Saat menerapkan pola kontrol Item Seleksi, perhatikan panduan dan konvensi berikut:
- Kontrol pilihan tunggal yang mengelola kontrol anak yang mengimplementasikan IRawElementProviderFragmentRoot, seperti penggeser Resolusi Layar dalam kotak dialog Properti Tampilan, harus diterapkan dan turunannya harus mengimplementasikan ISelectionProvider dan IRawElementProviderFragmentISelectionItemProvider.
Anggota yang Diperlukan untuk ISelectionProvider
Properti, metode, dan peristiwa berikut diperlukan untuk menerapkan ISelectionItemProvider.
| Anggota yang diperlukan | Jenis anggota | Catatan |
|---|---|---|
| CanSelectMultiple | Properti | Tidak |
| IsSelectionRequired | Properti | Tidak |
| GetSelection | Metode | Tidak |
| InvalidatedEvent | Kejadian | Dimunculkan ketika pilihan dalam kontainer telah berubah secara signifikan dan mengharuskan pengiriman semakin ElementSelectedEvent banyak dan ElementRemovedFromSelectionEvent peristiwa daripada InvalidateLimit izin konstanta. |
- Jika hasil dari Select, AddToSelection, atau RemoveFromSelection adalah satu item yang dipilih, ElementSelectedEvent harus dimunculkan; jika tidak kirim ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent sebagaimana mestinya.
Pengecualian
Penyedia harus menampilkan pengecualian berikut.
| Jenis pengecualian | Kondisi |
|---|---|
| InvalidOperationException | Ketika salah satu hal berikut ini dicoba: - RemoveFromSelection dipanggil pada kontainer pilihan tunggal ketika IsSelectionRequiredProperty = true dan elemen sudah dipilih.- RemoveFromSelection dipanggil pada kontainer pilihan ganda ketika IsSelectionRequiredProperty = true dan hanya satu elemen yang dipilih.- AddToSelection dipanggil pada kontainer pilihan tunggal ketika CanSelectMultipleProperty = false dan elemen sudah dipilih. |