Menerapkan Pola Kontrol Item Pilihan pada Otomatisasi Antarmuka Pengguna

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 ISelectionItemProvider, termasuk informasi tentang properti, metode, dan peristiwa. Tautan ke referensi tambahan tercantum di akhir gambaran umum.

Pola kontrol SelectionItemPattern digunakan untuk mendukung kontrol yang bertindak sebagai item turunan individu yang dapat dipilih dari kontrol kontainer yang mengimplementasikan ISelectionProvider. Untuk contoh kontrol yang mengimplementasikan pola kontrol SelectionItem, lihat Pemetaan Pola Kontrol untuk Klien Automation UI.

Pedoman dan Konvensi Implementasi

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

• Kontrol tunggal yang mengelola kontrol anak yang mengimplementasikan IRawElementProviderFragmentRoot, seperti penggeser Resolusi Layar dalam kotak dialog Properti Tampilan , harus menerapkan ISelectionProvider dan turunannya harus menerapkan baik IRawElementProviderFragment maupun ISelectionItemProvider.

Anggota yang Diperlukan untuk ISelectionItemProvider

Properti, metode, dan peristiwa berikut diperlukan untuk menerapkan ISelectionItemProvider.

Anggota yang diperlukan	Jenis anggota	Catatan
IsSelected	Harta benda	Tidak
SelectionContainer	Harta benda	Tidak
AddToSelection	Metode	Tidak
RemoveFromSelection	Metode	Tidak
Select	Metode	Tidak
ElementSelectedEvent	Peristiwa	Dimunculkan saat perubahan pilihan menghasilkan satu item terpilih.
ElementAddedToSelectionEvent	Peristiwa	Diaktifkan saat item ditambahkan ke wadah multi-pilihan.
ElementRemovedFromSelectionEvent	Peristiwa	Dimunculkan saat item dihapus dari kontainer multi-pilihan.
InvalidatedEvent	Peristiwa	Dimunculkan ketika pilihan dalam kontainer telah berubah secara signifikan dan mengharuskan pengiriman lebih banyak peristiwa ElementSelectedEvent dan ElementRemovedFromSelectionEvent daripada izin konstanta InvalidateLimit.

• Jika operasi Select, AddToSelection, atau RemoveFromSelection menghasilkan satu item yang dipilih, aktifkan ElementSelectedEvent; jika tidak, aktifkan ElementAddedToSelectionEvent atau ElementRemovedFromSelectionEvent yang sesuai.

Pengecualian

Penyedia harus memberikan pengecualian berikut.

Jenis pengecualian

Keadaan

InvalidOperationException

Ketika salah satu hal berikut ini dicoba: - RemoveFromSelection dipanggil pada kontainer pilihan tunggal di mana IsSelectionRequiredProperty = true dan elemen sudah dipilih. - RemoveFromSelection dipanggil pada kontainer pilihan ganda di mana IsSelectionRequiredProperty = true dan hanya satu elemen yang dipilih. - AddToSelection dipanggil pada kontainer pilihan tunggal di mana CanSelectMultipleProperty = false dan elemen lain sudah dipilih.

Lihat juga

• Gambaran Umum Pola Kontrol Automasi UI
• Pola Dukungan Kontrol dalam Penyedia Automasi Antarmuka Pengguna
• Pola Kontrol Automasi Antarmuka Pengguna untuk Klien
• Menerapkan Pola Kontrol Pemilihan Automasi UI
• Gambaran Umum Pohon Automasi UI
• Gunakan Cache dalam Otomatisasi UI
• Sampel Penyedia Fragmen