Bagikan melalui

Jenis Kontrol AppBar

  • Artikel

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

Bilah aplikasi adalah elemen UI yang menyajikan navigasi, perintah, dan alat kepada pengguna. Untuk aplikasi Windows Store, bilah aplikasi untuk aplikasi dapat ditampilkan dengan menekan Tombol Windows + Z.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol AppBar.

Topik ini berisi bagian berikut.

Struktur Pohon Umum

Tabel berikut ini menggambarkan kontrol umum dan tampilan konten pohon Automation UI yang berkaitan dengan AppBar kontrol dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Button adalah elemen paling umum dalam AppBar tetapi kontrol lain yang memanggil tindakan untuk aplikasi juga dimungkinkan. AppBar juga dapat memiliki 0 pemisah atau lebih (Pemisah jenis kontrol), yang muncul dalam tampilan kontrol seperti yang ditempatkan di antara kontrol lainnya. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI .

Tampilan Kontrol Tampilan Isi
  • AppBar
    • Tombol (0 atau banyak)
    • Kontrol lain (0 atau banyak)
  • Tidak berlaku
    • Tombol (0 atau banyak)
    • Kontrol lain (0 atau banyak)

 

Properti yang Relevan

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

Properti Automasi UI Nilai Catatan
UIA_AutomationIdPropertyId Lihat catatan. Nilai properti ini harus unik di antara semua elemen serekan dalam tampilan mentah pohon Automation UI.
UIA_BoundingRectanglePropertyId Lihat catatan. Nilai yang diekspos oleh properti ini harus menyertakan semua kontrol yang terkandung di dalamnya.
UIA_ControlTypePropertyId AppBar
UIA_IsContentElementPropertyId PALSU Kontrol bilah aplikasi tidak disertakan dalam tampilan konten pohon Automation UI.
UIA_IsControlElementPropertyId BENAR Kontrol bilah aplikasi selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_IsKeyboardFocusablePropertyId Lihat catatan Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini. Kontrol dalam bilah aplikasi biasanya dapat mengambil fokus keyboard.
UIA_IsOffscreenPropertyId Lihat catatan. Nilai properti ini tergantung pada apakah kontrol dapat dilihat pada layar.
UIA_LabeledByPropertyId Nol Kontrol bilah aplikasi biasanya tidak memiliki label.
UIA_LocalizedControlTypePropertyId Lihat catatan. String yang dilokalkan sesuai dengan jenis kontrol AppBar. Nilai defaultnya adalah "bilah aplikasi" untuk en-US atau Inggris (Amerika Serikat).
UIA_NamePropertyId Lihat catatan. Kontrol bilah aplikasi tidak memerlukan nama kecuali aplikasi memiliki lebih dari satu bilah aplikasi. Jika ada lebih dari satu bilah aplikasi dalam aplikasi, gunakan properti ini untuk mengekspos nama yang membedakan, seperti "Atas" atau "Bawah."

 

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automation UI yang diperlukan kontrol bilah aplikasi 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_StructureChangedEventId

 

Peristiwa yang Relevan

Tabel berikut mencantumkan peristiwa Automasi UI yang sangat relevan dengan kontrol yang mengimplementasikan jenis kontrol AppBar tetapi tidak diperlukan secara ketat.

Peristiwa Automasi UI Catatan
UIA_MenuClosedEventId Implementasi platform mungkin mengaktifkan peristiwa ini saat kontrol bilah aplikasi ditutup.
UIA_MenuOpenedEventId Implementasi platform mungkin mengaktifkan peristiwa ini saat kontrol bilah aplikasi dibuka.
IUIAutomationPropertyChangedEventHandler Penanganan aktivitas yang diubah properti.

 

Konseptual

Gambaran Umum Tipe Kontrol Automasi UI

Gambaran Umum Automasi UI

Referensi

kontrol AppBar XAML

objek WinJS.UI.AppBar