Bagikan melalui

Dukungan Automasi UI untuk Jenis Kontrol Menu

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 Microsoft UI Automation untuk jenis kontrol Menu. Ini menjelaskan struktur pohon Microsoft UI Automation kontrol dan menyediakan properti dan pola kontrol untuk skenario kontrol tertentu.

Kontrol menu memungkinkan organisasi hierarkis elemen yang terkait dengan perintah dan penanganan aktivitas. Dalam aplikasi Microsoft Windows biasa, bilah menu berisi beberapa tombol menu (seperti File, Edit, dan Window), dan setiap tombol menu menampilkan menu. Menu berisi kumpulan item menu (seperti New, Open, dan Close), 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 Otomasi UI yang diperlukan untuk jenis kontrol Menu. Persyaratan Otomatisasi UI berlaku untuk semua kontrol daftar, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.

Struktur Pohon Automasi UI yang Diperlukan

Tabel berikut ini menggambarkan tampilan kontrol dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol menu 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
Daftar Pilihan

- MenuItem (1 atau banyak)		 Tidak berlaku (kecuali kontrol menu adalah menu konteks yang merupakan induk objek yang bukan item menu)

- MenuItem (1 atau banyak)

Kontrol menu selalu muncul dalam tampilan kontrol dan tampilan konten pohon Automation UI. Jenis kontrol menu seharusnya muncul di bawah kontrol yang informasinya dirujuk. Klien UI Automation harus mendengarkan MenuOpenedEvent untuk memastikan bahwa mereka secara konsisten memperoleh informasi yang disampaikan oleh kontrol menu. Kontrol menu konteks adalah kasus khusus. Mereka muncul sebagai anak-anak Desktop.

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan jenis kontrol Menu. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.

Properti Automasi Antarmuka Pengguna Nilai Catatan
NameProperty Tidak Didukung Kontrol menu tidak memerlukan pengaturan properti Nama.
LabeledByProperty Null Tidak ada label yang diantisipasi dengan kontrol menu yang khas.
ControlTypeProperty Daftar Pilihan Nilai ini sama untuk semua kerangka kerja UI.
IsContentElementProperty Tidak benar Kontrol menu tidak disertakan dalam tampilan konten pohon Automation UI.
IsControlElementProperty Benar Kontrol menu selalu disertakan dalam tampilan kontrol pohon Automation UI.

Pola Kontrol Automasi UI yang Diperlukan

Tidak ada pola kontrol yang diperlukan untuk jenis kontrol Menu.

Peristiwa Automasi UI yang Diperlukan

Kontrol menu harus memicu MenuOpenedEvent ketika muncul di layar. MenuOpenedEvent akan menyertakan teks kontrol. MenuClosedEvent harus dinaikkan ketika menu menghilang dari layar.

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol menu. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .

Peristiwa UI Automation Dukungan/Nilai Catatan
MenuOpenedEvent Diperlukan Tidak ada
MenuClosedEvent Diperlukan Tidak ada
BoundingRectangleProperty acara perubahan properti. Diperlukan Tidak ada
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
AutomationFocusChangedEvent Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada

Lihat juga

  • Last updated on