Dukungan Automasi Antarmuka Pengguna untuk Jenis Kontrol Menu
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 Automasi Antarmuka Pengguna Microsoft untuk jenis kontrol Menu. Ini menggambarkan struktur pohon Automasi Antarmuka Pengguna Microsoft kontrol dan menyediakan properti dan pola kontrol untuk skenario kontrol tertentu.
Kontrol menu memungkinkan organisasi hierarki elemen yang terkait dengan perintah dan penangan peristiwa. Dalam aplikasi Microsoft Windows pada umumnya, bilah menu berisi beberapa tombol menu (seperti File, Edit, dan Window), dan setiap tombol menu menampilkan menu. Menu berisi kumpulan item menu (seperti Baru, Buka, dan Tutup), yang dapat diperluas untuk menampilkan item menu tambahan atau untuk melakukan tindakan tertentu saat diklik.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa yang diperlukan Automasi Antarmuka Pengguna untuk jenis kontrol Menu. 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 pohon Automasi Antarmuka Pengguna yang berkaitan dengan kontrol menu dan menjelaskan apa yang dapat terkandung dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Menu - MenuItem (1 atau banyak) |
Tidak berlaku (kecuali kontrol menu adalah menu konteks yang merupakan induk dari objek yang bukan item menu) - MenuItem (1 atau banyak) |
Kontrol menu selalu muncul dalam tampilan kontrol dan tampilan konten pohon Automasi Antarmuka Pengguna. Jenis kontrol menu akan muncul di bawah kendali yang dimaksud dengan informasi tersebut. Klien Automasi Antarmuka Pengguna harus mendengarkan MenuOpenedEvent untuk memastikan bahwa mereka secara konsisten mendapatkan informasi yang disampaikan oleh kontrol menu. Kontrol menu konteks adalah kasus khusus. Mereka muncul sebagai turunan dari desktop.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti Automasi Antarmuka Pengguna yang nilai atau definisinya sangat relevan dengan jenis kontrol Menu. Untuk informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| NameProperty | Tidak Didukung | Kontrol menu tidak memerlukan properti Nama untuk diatur. |
| LabeledByProperty | Null |
Tidak ada label yang diantisipasi dengan kontrol menu yang khas. |
| ControlTypeProperty | Menu | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Salah | Kontrol menu tidak termasuk dalam tampilan konten pohon Automasi Antarmuka Pengguna. |
| IsControlElementProperty | Benar | Kontrol menu selalu disertakan dalam tampilan kontrol pohon Automasi Antarmuka Pengguna. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tidak ada pola kontrol yang diperlukan untuk jenis kontrol Menu.
Peristiwa UI Automation yang Diperlukan
Kontrol menu harus menaikkan MenuOpenedEvent saat muncul di layar. MenuOpenedEvent akan menyertakan teks kontrol. MenuClosedEvent harus dinaikkan ketika menu menghilang dari layar.
Tabel berikut mencantumkan peristiwa Automasi Antarmuka Pengguna yang harus didukung oleh semua kontrol menu. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan/Nilai | Catatan |
|---|---|---|
| MenuOpenedEvent | Wajib | Tidak |
| MenuClosedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |