Bagikan melalui


Menerapkan Pola Kontrol Pengalih Otomatisasi 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 IToggleProvider, termasuk informasi tentang metode dan properti. Tautan ke referensi tambahan tercantum di akhir topik.

Pola TogglePattern kontrol digunakan untuk mendukung kontrol yang dapat menelusuri serangkaian status dan mempertahankan status sekali diatur. Untuk contoh kontrol yang menerapkan pola kontrol ini, lihat Pemetaan Pola Kontrol untuk Klien Automasi UI.

Pedoman dan Konvensi Implementasi

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

  • Kontrol yang tidak mempertahankan status saat diaktifkan, seperti tombol, tombol toolbar, dan hyperlink, harus diterapkan IInvokeProvider sebagai gantinya.

  • Kontrol harus melalui ToggleState dalam urutan berikut: On, Off dan, jika didukung, Indeterminate.

  • TogglePattern tidak menyediakan metode SetState(newState) karena masalah seputar pengaturan langsung CheckBox tri-state tanpa melewati urutan yang sesuai ToggleState.

  • Kontrol RadioButton tidak mengimplementasikan IToggleProvider, karena tidak mampu berputar melalui status validnya.

Anggota yang Diperlukan untuk IToggleProvider

Properti dan metode berikut diperlukan untuk menerapkan IToggleProvider.

Anggota yang diperlukan Jenis anggota Catatan
Toggle Metode Tidak ada
ToggleStateProperty Harta benda Tidak ada

Pola kontrol ini tidak memiliki peristiwa terkait.

Pengecualian

Pola kontrol ini tidak memiliki pengecualian terkait.

Lihat juga