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 Automation UI untuk jenis kontrol ToolBar. 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. Kontrol bilah alat memungkinkan pengguna akhir mengaktifkan perintah dan alat yang terkandung dalam aplikasi.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol ToolBar. Persyaratan Otomatisasi UI berlaku untuk semua kontrol bilah alat, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.
Struktur Pohon Automasi UI yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol bilah alat 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 |
|---|---|
| Bilah Alat - Berbagai kontrol (0 atau lebih) |
Bilah Alat - Berbagai kontrol (0 atau lebih) |
Kontrol bilah alat dapat berisi semua jenis kontrol dalam subtreenya. Mereka paling sering berisi tombol, kotak kombo, dan tombol terpisah.
Properti Otomasi Antarmuka Pengguna yang Dibutuhkan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol bilah alat. 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 panjang 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. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, 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 pembeda (misalnya, Pemformatan atau Penggambaran). |
| LabeledByProperty | Null |
Kontrol bilah alat tidak pernah memiliki label. |
| ControlTypeProperty | Bilah Alat | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "bilah alat" | Teks yang sudah dilokalkan untuk jenis kontrol ToolBar. |
| IsContentElementProperty | Benar | Kontrol bilah alat selalu konten. |
| IsControlElementProperty | Benar | Kontrol bilah alat harus selalu berfungsi sebagai kontrol. |
Pola Kontrol Automasi UI yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automation UI yang harus didukung oleh kontrol bilah alat. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI .
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| ExpandCollapsePattern | Bergantung | Jika bilah alat dapat diperluas dan diciutkan untuk menampilkan lebih banyak item, maka harus mendukung pola ini. |
| DockPattern | Bergantung | Jika bilah alat dapat dijangkar ke berbagai bagian layar, maka harus mendukung pola ini. |
| TransformPattern | Bergantung | Jika bilah alat dapat diubah ukurannya, diputar, atau dipindahkan, bilah alat harus mendukung pola ini. |
Peristiwa Automasi UI yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang harus didukung oleh semua kontrol bilah alat. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .
| Peristiwa Automasi UI | Dukungan | Catatan |
|---|---|---|
| BoundingRectangleProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsOffscreenProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsEnabledProperty acara perubahan properti. | Diperlukan | Tidak ada |
| ExpandCollapseStateProperty acara perubahan properti. | Bergantung | Tidak ada |
| AutomationFocusChangedEvent | Diperlukan | Tidak ada |
| StructureChangedEvent | Diperlukan | Tidak ada |
Lihat juga
- ToolBar
- Gambaran Umum Tipe Kontrol Automasi UI
- Gambaran Umum Automasi UI