Dukungan UI Automation untuk Jenis Kontrol ComboBox
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 UI Automation untuk jenis kontrol. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Ketentuan tersebut mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, pola kontrol, dan peristiwa UI Automation.
Kotak kombo adalah kotak daftar yang dikombinasikan dengan kontrol statis atau kontrol edit yang menampilkan item yang saat ini dipilih di bagian kotak daftar kotak kombo. Bagian kotak daftar kontrol ditampilkan setiap saat atau hanya muncul saat pengguna memilih panah turun bawah (yang merupakan tombol tekan) di samping kontrol. Jika bidang pilihan adalah kontrol edit, pengguna dapat memasukkan informasi yang tidak ada dalam daftar; jika tidak, pengguna hanya dapat memilih item dalam daftar.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol ComboBox. Persyaratan UI Automation berlaku untuk semua kontrol kotak kombo, 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 kotak kombo dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| ComboBox - Edit (0 atau 1) - Daftar (1) - Item Daftar (anak dari Daftar; 0 hingga banyak) - Tombol (1) |
ComboBox - Item Daftar (0 hingga banyak) |
Kontrol edit dalam tampilan kontrol kotak kombo hanya diperlukan jika kotak kombo dapat diedit untuk mengambil input apa pun, seperti halnya kotak kombo dalam kotak dialog Jalankan.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai 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 | ComboBox | Nilai ini sama untuk semua kerangka kerja UI. |
| HelpTextProperty | Lihat catatan. | Teks bantuan untuk kontrol kotak kombo harus menjelaskan mengapa pengguna diminta untuk memilih opsi dari kotak kombo. Teks mirip dengan informasi yang disajikan melalui tooltip. Misalnya, "Pilih item untuk mengatur resolusi tampilan monitor Anda". |
| IsContentElementProperty | Benar | Kontrol kotak kombo selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol kotak kombo selalu disertakan dalam tampilan kontrol pohon UI Automation. |
| IsKeyboardFocusableProperty | Benar | Kontrol kotak kombo mengekspos sekumpulan item dari kontainer pilihan. Kontrol kotak kombo dapat menerima fokus keyboard, meskipun ketika klien Automation UI menetapkan fokus pada kotak kombo, item apa pun dalam subtree kotak kombo mungkin menerima fokus. |
| LabeledByProperty | Lihat catatan. | Kontrol kotak kombo biasanya memiliki label teks statis yang dirujuk properti ini. |
| LocalizedControlTypeProperty | "combo box" | String yang dilokalkan sesuai dengan jenis kontrol ComboBox. |
| NameProperty | Lihat catatan. | Kontrol kotak kombo biasanya mendapatkan namanya dari kontrol teks statis. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol kotak kombo. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IExpandCollapseProvider | Ya | Kontrol kotak kombo harus selalu berisi tombol drop-down agar menjadi kotak kombo. |
| ISelectionProvider | Ya | Menampilkan pilihan saat ini dalam kotak kombo. Dukungan ini didelegasikan ke kotak daftar di bawah kotak kombo. |
| IValueProvider | Bergantung | Jika kotak kombo memiliki kemampuan untuk mengambil nilai teks arbitrer, pola Nilai harus didukung. Pola ini menyediakan kemampuan untuk mengatur konten string kotak kombo secara terprogram. Jika pola Nilai tidak didukung, ini menunjukkan bahwa pengguna harus membuat pilihan dari item daftar dalam subtree kotak kombo. |
| IScrollProvider | Tidak pernah | Pola Gulir tidak pernah didukung pada kotak kombo secara langsung. Ini didukung jika kotak daftar yang terkandung dalam kotak kombo dapat menggulir. Ini mungkin hanya didukung ketika kotak daftar terlihat di layar. |
Peristiwa yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol kotak kombo. Untuk informasi selengkapnya tentang acara, baca 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 |
| ExpandCollapseStateProperty peristiwa perubahan properti. | Wajib | Tidak |
| ValueProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola Gulir, kontrol harus mendukung peristiwa ini. |