Dukungan UI Automation untuk Jenis Kontrol Kotak Centang
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 memberikan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol CheckBox. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
Kotak centang adalah objek yang digunakan untuk menunjukkan status yang dapat berinteraksi dengan pengguna untuk menelusuri status tersebut. Kotak centang menyajikan opsi biner (Ya/Tidak), (Aktif/Nonaktif), atau tersier (Aktif, Nonaktif, Tidak Ditentukan) kepada pengguna.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol Kalender. Persyaratan UI Automation berlaku untuk semua kontrol kalender, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol kalender dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| KotakCentang | KotakCentang |
Catatan
Kotak centang tidak pernah memiliki elemen turunan dalam tampilan kontrol atau konten. Jika kontrol memang perlu berisi elemen turunan, ini menunjukkan bahwa jenis kontrol lain harus digunakan.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilainya atau definisinya sangat relevan dengan kontrol Tabel. Untuk mendapatkan informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AutomationIdProperty | Lihat catatan. | Nilai properti ini harus unik di semua kontrol dalam aplikasi. |
| BoundingRectangleProperty | Lihat catatan. | Persegi terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam kotak pembatas dapat diklik, dan Anda melakukan pengujian hit khusus, maka ambil alih dan berikan titik yang dapat diklik. |
| ControlTypeProperty | KotakCentang | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Benar | Nilai properti ini harus selalu True. Ini berarti bahwa kontrol kotak centang harus selalu disertakan dalam tampilan konten pohon Automation UI. |
| IsControlElementProperty | Benar | Nilai properti ini harus selalu True. Ini berarti bahwa kontrol kotak centang harus selalu disertakan dalam tampilan konten pohon Automation UI. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| LabeledByProperty | Null |
Kotak centang adalah kontrol pelabelan mandiri. |
| LocalizedControlTypeProperty | "kotak centang" | String yang dilokalkan sesuai dengan jenis kontrol Kalender. |
| NameProperty | Lihat catatan. | Nilai properti kontrol Name kotak centang adalah teks yang ditampilkan di samping kotak yang mempertahankan status pengalih. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol kalender. Untuk mendapatkan informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IToggleProvider | Wajib | Memungkinkan kotak centang diputar melalui status internalnya secara terprogram. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol kalender. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AutomationFocusChangedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |
| ToggleStateProperty peristiwa perubahan properti. | Wajib | Tidak |
Tindakan default
Tindakan default kotak centang adalah untuk menyebabkan tombol radio menjadi fokus dan mengalihkan statusnya saat ini. Seperti disebutkan sebelumnya, kotak centang menyajikan keputusan biner (Ya/Tidak) (Aktif/Nonaktif) kepada pengguna atau tersier (Aktif, Nonaktif, Tidak Ditentukan). Jika kotak centang adalah biner, tindakan default menyebabkan status "aktif" menjadi "nonaktif" atau status "nonaktif" menjadi "aktif". Dalam kotak centang status tersier, tindakan default berputar melalui status kotak centang dalam urutan yang sama seolah-olah pengguna telah mengirim klik mouse berturut-turut ke kontrol.