Menerapkan Pola Kontrol Beralih 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 IToggleProvider, termasuk informasi tentang metode dan properti. Link ke referensi tambahan tercantum di akhir topik.
Pola kontrol TogglePattern digunakan untuk mendukung kontrol yang dapat menelusuri kumpulan status dan mempertahankan status setelah diatur. Untuk contoh kontrol yang menerapkan pola kontrol ini, baca Pemetaan Pola Kontrol untuk Klien UI Automation.
Pedoman dan Konvensi Implementasi
Saat menerapkan pola kontrol Toggle, perhatikan panduan dan konvensi berikut:
Kontrol yang tidak mempertahankan status saat diaktifkan, seperti tombol, tombol bilah alat, dan hyperlink, harus menerapkan IInvokeProvider sebagai gantinya.
Kontrol harus menelusuri ToggleState dalam urutan berikut: On, Off dan, jika didukung, Indeterminate.
TogglePattern tidak menyediakan metode SetState(newState) karena masalah seputar pengaturan langsung Kotak Centang tri-state menelusuri melalui urutan ToggleState yang sesuai.
Kontrol RadioButton tidak mengimplementasikan IToggleProvider, karena tidak mampu menelusuri status validnya.
Anggota yang Diperlukan untuk IToggleProvider
Properti dan metode berikut perlu menerapkan IToggleProvider.
| Anggota yang diperlukan | Jenis anggota | Catatan |
|---|---|---|
| Toggle | Metode | Tidak |
| ToggleStateProperty | Properti | Tidak |
Pola kontrol ini tidak memiliki peristiwa terkait.
Pengecualian
Pola kontrol ini tidak memiliki pengecualian terkait.