Tipe Kontrol Panel

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

Jenis kontrol Panel adalah untuk wilayah yang berpotensi dapat digulir yang memiliki konten yang berbeda. Ini digunakan untuk mewakili objek dalam bingkai atau jendela dokumen. Pengguna dapat menavigasi antara kontrol panel dan di dalam konten panel saat ini. Kontrol panel mewakili tingkat pengelompokan yang lebih rendah dari jendela atau dokumen, tetapi di atas kontrol individual. Pengguna menavigasi antar panel dengan menekan TAB, F6, atau CTRL+TAB, tergantung pada konteksnya.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Panel . Persyaratan Otomatisasi UI berlaku untuk semua kontrol panel tempat kerangka kerja/platform UI mengintegrasikan dukungan Automation UI untuk jenis kontrol dan pola kontrol.

Topik ini berisi bagian berikut.

• Struktur Pohon Umum
• Properti yang Relevan
• Pola Kontrol yang Diperlukan
• Peristiwa yang Diperlukan
• Contoh Jenis Kontrol Panel
• Topik terkait

Struktur Pohon Umum

Tabel berikut ini menggambarkan kontrol umum dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol panel dan menjelaskan apa yang bisa dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.

Tampilan Kontrol	Tampilan Konten
Panel	Panel

 

Kontrol panel selalu muncul dalam tampilan kontrol dan konten. Jangan mengekspos objek tata letak sebagai panel dalam tampilan kontrol atau konten jika objek hanya digunakan untuk presentasi visual.

Properti yang Relevan

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

Properti UI Automation	Nilai	Catatan
UIA_AccessKeyPropertyId	Lihat catatan.	Jika kombinasi kunci tertentu memberikan fokus ke panel, informasi tersebut harus diekspos melalui properti ini.
UIA_AutomationIdPropertyId	Lihat catatan.	Nilai properti ini harus unik di antara semua elemen serekan dalam tampilan mentah pohon Automation UI.
UIA_BoundingRectanglePropertyId	Lihat catatan.	Persegi panjang terluar yang berisi seluruh kontrol.
UIA_ClickablePointPropertyId	Lihat catatan.	Properti ini mengekspos titik yang dapat diklik dari kontrol panel yang menyebabkan panel menjadi fokus saat diklik.
UIA_ControlTypePropertyId	Panel
UIA_HelpTextPropertyId	Lihat catatan.	Teks bantuan untuk kontrol panel harus menjelaskan tujuan bingkai dan bagaimana kaitannya dengan bingkai lain. Deskripsi diperlukan jika tujuan dan hubungan bingkai tidak jelas dari nilai properti UIA_NamePropertyId .
UIA_IsContentElementPropertyId	TRUE	Kontrol panel selalu disertakan dalam tampilan konten pohon Automation UI.
UIA_IsControlElementPropertyId	TRUE	Kontrol panel selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_IsKeyboardFocusablePropertyId	Lihat catatan.	Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini.
UIA_LabeledByPropertyId	Lihat catatan.	Kontrol panel biasanya tidak memiliki label statik. Jika ada label teks statik, ini harus diekspos melalui properti ini.
UIA_LocalizedControlTypePropertyId	Lihat catatan.	String yang dilokalkan sesuai dengan jenis kontrol Panel . Nilai defaultnya adalah "panel" untuk en-US atau English (Amerika Serikat).
UIA_NamePropertyId	Lihat catatan.	Nilai untuk properti ini harus selalu menjadi judul yang jelas, ringkas, dan bermakna.

 

Pola Kontrol yang Diperlukan

Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh kontrol panel. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.

Pola Kontrol	Dukungan	Catatan
IDockProvider	Bergantung	Terapkan pola kontrol Dock jika kontrol panel dapat ditampung.
IScrollProvider	Bergantung	Terapkan pola kontrol Gulir jika kontrol panel dapat digulir.
ITransformProvider	Bergantung	Terapkan pola kontrol Transformasi jika kontrol panel dapat dipindahkan, diubah ukurannya, atau diputar di layar.
IWindowProvider	Tidak pernah	Jika elemen perlu menerapkan pola kontrol Jendela , kontrol harus didasarkan pada jenis kontrol Jendela .

 

Peristiwa yang Diperlukan

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

Peristiwa UI Automation	Catatan
UIA_AsyncContentLoadedEventId
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti.
UIA_IsOffscreenPropertyId peristiwa yang diubah properti.	Jika kontrol mendukung properti IsOffscreen , kontrol harus mendukung kejadian ini.
UIA_ScrollHorizontallyScrollablePropertyId peristiwa yang diubah properti.	Jika kontrol mendukung pola kontrol Gulir , kontrol harus mendukung peristiwa ini.
UIA_ScrollHorizontalScrollPercentPropertyId peristiwa yang diubah properti.	Jika kontrol mendukung pola kontrol Gulir , kontrol harus mendukung peristiwa ini.
UIA_ScrollHorizontalViewSizePropertyId peristiwa yang diubah properti.	Jika kontrol mendukung pola kontrol Gulir , kontrol harus mendukung peristiwa ini.
UIA_ScrollVerticallyScrollablePropertyId peristiwa yang diubah properti.	Jika kontrol mendukung pola kontrol Gulir , kontrol harus mendukung peristiwa ini.
UIA_ScrollVerticalScrollPercentPropertyId peristiwa yang diubah properti.	Jika kontrol mendukung pola kontrol Gulir , kontrol harus mendukung peristiwa ini.
UIA_ScrollVerticalViewSizePropertyId peristiwa yang diubah properti.	Jika kontrol mendukung pola kontrol Gulir , kontrol harus mendukung peristiwa ini.
UIA_StructureChangedEventId

 

Contoh Jenis Kontrol Panel

Gambar berikut mengilustrasikan kontrol yang mengimplementasikan jenis kontrol Panel .

Pohon Otomatisasi UI—Tampilan Kontrol	Pohon Otomatisasi UI—Tampilan Konten
Panel Pohon (Pola Gulir) TreeItem ... Panel Edit (Pola Gulir)	Panel Pohon (Pola Gulir) TreeItem ... Panel Edit (Pola Gulir)

 

Topik terkait

Konseptual

Gambaran Umum Jenis Kontrol UI Automation

Gambaran Umum UI Automation