Dukungan UI Automation untuk Jenis Kontrol MenuBar
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 MenuBar. 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 progres adalah contoh kontrol yang menerapkan jenis kontrol ProgressBar. Bilah menu menyediakan sarana bagi pengguna untuk mengaktifkan perintah dan opsi yang terkandung 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 daftar, 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 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 |
|---|---|
| MenuBar - MenuItem (1 atau lebih) - Kontrol lain (0 atau banyak) |
MenuBar - MenuItem (1 atau lebih) - Kontrol lain (0 atau banyak) |
Kontrol bilah menu dapat berisi kontrol lain seperti kontrol edit dan kotak kombo dalam strukturnya. Kontrol tambahan ini sesuai dengan "kontrol lain" yang tercantum di atas dalam tampilan kontrol dan konten.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol kalender. Untuk informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| BoundingRectangleProperty | Lihat catatan. | Nilai yang diekspos oleh properti ini harus menyertakan semua kontrol yang terkandung di dalamnya. |
| NameProperty | Lihat catatan. | Kontrol bilah menu tidak memerlukan nama kecuali aplikasi memiliki lebih dari satu bilah menu. Jika ada lebih dari satu bilah menu dalam aplikasi, properti ini harus digunakan untuk mengekspos nama pembeda, seperti "Pemformatan" atau "Kerangka." |
| LabeledByProperty | Null |
Kontrol bilah alat tidak pernah memiliki label. |
| ControlTypeProperty | MenuBar | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "menu bar" | String yang dilokalkan sesuai dengan jenis kontrol ToolBar. |
| IsContentElementProperty | Benar | Kontrol kalender selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol kalender selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsOffscreenProperty | Lihat catatan. | Nilai properti ini tergantung pada apakah kontrol dapat dilihat pada layar. |
| OrientationProperty | Bergantung | Properti ini memaparkan apakah kontrol bilah menu horizontal atau vertikal. |
| IsKeyboardFocusableProperty | Benar | Kontrol bilah menu dapat difokuskan dengan keyboard karena kontrol yang dikandungnya dapat mengambil fokus keyboard. |
| HelpTextProperty | Lihat catatan. | Tidak ada skenario ketika teks Bantuan diperlukan untuk kontrol bilah menu. |
| AcceleratorKeyProperty | Null |
Bilah menu tidak pernah memiliki kunci akselerator. |
| AccessKeyProperty | "ALT" | Menekan tombol ALT harus selalu membawa fokus ke bilah menu dalam aplikasi. |
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 |
|---|---|---|
| IExpandCollapseProvider | Bergantung | Jika kontrol dapat diperluas atau diciutkan, terapkan IExpandCollapseProvider. |
| IDockProvider | Bergantung | Jika kontrol dapat ditampung ke berbagai bagian layar, terapkan IDockProvider. |
| ITransformProvider | Bergantung | Jika kontrol dapat diubah ukurannya, diputar, atau dipindahkan, kontrol harus mengimplementasikan ITransformProvider. |
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/Nilai | 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 |