Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 menyediakan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol CheckBox. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.
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, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol Kotak Centang. Persyaratan Otomatisasi UI berlaku untuk semua kontrol kotak centang, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.
Struktur Pohon Automasi UI yang Diperlukan
Tabel berikut ini menggambarkan tampilan kontrol dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol kotak centang dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI.
| Tampilan Kontrol | Tampilan Isi |
|---|---|
| Kotak Centang | Kotak Centang |
Nota
Kotak centang tidak pernah memiliki elemen turunan di tampilan kontrol atau di tampilan konten. Jika kontrol memang perlu berisi elemen turunan, hal ini menunjukkan bahwa jenis kontrol lain sebaiknya digunakan.
Properti Otomasi Antarmuka Pengguna yang Dibutuhkan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol kotak centang. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.
| Properti Automasi Antarmuka Pengguna | 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 persegi panjang pembatas dapat diklik, dan Anda melakukan pengujian hit khusus, maka ambil alih dan berikan titik yang dapat diklik. |
| ControlTypeProperty | Kotak Centang | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Benar | Nilai properti ini harus selalu Benar. Ini berarti bahwa kontrol kotak centang harus selalu disertakan dalam tampilan konten pohon Automation UI. |
| IsControlElementProperty | Benar | Nilai properti ini harus selalu Benar. Ini berarti bahwa kontrol kotak centang harus selalu disertakan dalam tampilan kontrol 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 Kotak Centang. |
| NameProperty | Lihat catatan. | Nilai properti kontrol Name kotak centang adalah teks yang ditampilkan di samping kotak yang mempertahankan status pengalih. |
Pola Kontrol Automasi UI yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automasi UI yang diperlukan untuk didukung oleh semua kontrol kotak centang. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IToggleProvider | Diperlukan | Memungkinkan kotak centang digilir melalui status internalnya secara terprogram. |
Peristiwa Automasi UI yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol kotak centang. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AutomationFocusChangedEvent | Diperlukan | Tidak ada |
| BoundingRectangleProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsOffscreenProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsEnabledProperty acara perubahan properti. | Diperlukan | Tidak ada |
| StructureChangedEvent | Diperlukan | Tidak ada |
| ToggleStateProperty acara perubahan properti. | Diperlukan | Tidak ada |
Tindakan default
Tindakan default kotak centang adalah 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 menelusuri status kotak centang dalam urutan yang sama seolah-olah pengguna telah mengirim klik mouse berturut-turut ke kontrol.