Bagikan melalui

Tipe Kontrol Menu

  • Artikel

Topik ini menyediakan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol Menu.

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 Automation UI yang diperlukan untuk jenis kontrol Menu. Persyaratan Automasi UI berlaku untuk semua kontrol menu tempat kerangka kerja/platform UI mengintegrasikan dukungan Automation UI untuk jenis kontrol dan pola kontrol.

Topik ini berisi bagian berikut.

Struktur Pohon Umum

Tabel berikut ini menggambarkan kontrol umum 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
  • Menu
    • MenuItem (1 atau banyak)
    • Kontrol lain (0 atau banyak)
  • Menu
    • MenuItem (1 atau banyak)
    • Kontrol lain (0 atau banyak)

 

Kontrol menu selalu muncul dalam tampilan kontrol dan tampilan konten pohon Automation UI. Kontrol menu akan muncul di bawah kontrol yang dirujuk oleh informasi mereka. Klien Automation UI dapat mendengarkan UIA_MenuOpenedEventId untuk memastikan bahwa mereka secara konsisten mendapatkan informasi yang disampaikan oleh kontrol menu. Kontrol menu konteks adalah kasus khusus. Mereka mungkin muncul sebagai anak-anak desktop atau dari jendela aplikasi tingkat atas.

Kontrol menu dapat berisi kontrol lain, seperti kontrol edit dan kotak kombo, dalam strukturnya. Kontrol tambahan ini sesuai dengan "kontrol lain" yang tercantum dalam tabel sebelumnya dalam tampilan kontrol dan konten.

Properti yang Relevan

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

Properti Automasi UI Nilai Catatan
UIA_ControlTypePropertyId Menu
UIA_IsContentElementPropertyId BENAR Kontrol menu selalu disertakan dalam tampilan konten pohon Automation UI.
UIA_IsControlElementPropertyId BENAR Kontrol menu selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_LabeledByPropertyId NOL Tidak ada label yang diantisipasi dengan kontrol menu yang khas.
UIA_NamePropertyId Lihat catatan. Kontrol menu tidak memerlukan properti Nama untuk diatur, atau bisa memiliki nama yang sama dengan kontrol terkait, seperti item menu yang membuka submenu.

 

Pola Kontrol yang Diperlukan

Tidak ada pola kontrol yang diperlukan untuk jenis kontrol Menu.

Peristiwa yang Diperlukan

Kontrol menu harus menaikkan peristiwa UIA_MenuOpenedEventId saat muncul di layar. Peristiwa UIA_MenuOpenedEventId akan menyertakan teks kontrol. Peristiwa UIA_MenuClosedEventId harus dinaikkan saat menu menghilang dari layar.

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

Peristiwa Automasi UI Catatan
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti.
UIA_IsEnabledPropertyId peristiwa yang diubah properti. Jika kontrol mendukung propertiIsEnabled, kontrol harus mendukung peristiwa ini.
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. Jika kontrol mendukung propertiIsOffscreen, kontrol harus mendukung peristiwa ini.
UIA_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

Konseptual

Gambaran Umum Tipe Kontrol Automasi UI

Gambaran Umum Automasi UI