Dukungan UI Automation untuk Jenis Kontrol ToolBar
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 ToolBar. 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. Kontrol bilah alat memungkinkan pengguna akhir mengaktifkan perintah dan alat yang terdapat dalam aplikasi.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol ToolBar. Persyaratan UI Automation berlaku untuk semua kontrol bilah alat, baik Windows Presentation Foundation (WPF), Win32, maupun Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol bilah alat 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 |
|---|---|
| ToolBar - Berbagai kontrol (0 atau lebih) |
ToolBar - Berbagai kontrol (0 atau lebih) |
Kontrol bilah alat dapat berisi semua jenis kontrol di dalam subpohonnya. Kontrol ini paling sering berisi tombol, kotak kombo, dan tombol pemisah.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol bilah alat. Untuk 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. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Bergantung | Kontrol bilah alat tidak memerlukan nama kecuali lebih dari satu digunakan dalam aplikasi. Jika ada lebih dari satu, masing-masing harus memiliki nama yang membedakan (misalnya, Pemformatan atau Penguraian). |
| LabeledByProperty | Null |
Kontrol bilah alat tidak pernah memiliki label. |
| ControlTypeProperty | ToolBar | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "tool bar" | String yang dilokalkan sesuai dengan jenis kontrol ToolBar. |
| IsContentElementProperty | Benar | Kontrol bilah alat selalu berisi konten. |
| IsControlElementProperty | Benar | Kontrol bilah alat harus selalu menjadi kontrol. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol bilah alat. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| ExpandCollapsePattern | Bergantung | Jika bilah alat dapat diperluas dan diciutkan untuk menampilkan lebih banyak item, bilah alat harus mendukung pola ini. |
| DockPattern | Bergantung | Jika bilah alat dapat dipasang ke bagian layar yang berbeda, bilah alat tersebut harus mendukung pola ini. |
| TransformPattern | Bergantung | Jika dapat diubah ukurannya, diputar, atau dipindahkan, bilah alat harus mendukung pola ini. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol bilah alat. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| ExpandCollapseStateProperty peristiwa perubahan properti. | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |