Dukungan UI Automation untuk Jenis Kontrol Panel
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 UI Automation untuk jenis kontrol Panel. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
Jenis kontrol Panel digunakan untuk mewakili objek dalam jendela bingkai atau dokumen. Pengguna dapat menavigasi antara kontrol panel dan di dalam konten panel saat ini, tetapi tidak dapat menavigasi antar item di panel yang berbeda. Dengan demikian, kontrol panel mewakili tingkat pengelompokan yang lebih rendah daripada jendela atau dokumen, tetapi di atas kontrol individu. Pengguna menavigasi antar panel dengan menekan TAB, F6, atau CTRL+TAB, tergantung pada konteksnya. Navigasi keyboard tertentu tidak diperlukan oleh jenis kontrol Panel.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa UI Automation yang diperlukan untuk jenis kontrol Panel. 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 UI Automation yang berkaitan dengan kontrol panel dan menjelaskan apa saja yang dapat terkandung dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Panel | Panel |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol panel. Untuk informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AutomationIdProperty | Lihat catatan. | Nilai properti ini harus unik di semua kontrol dalam aplikasi. |
| BoundingRectangleProperty | Lihat catatan. | Persegi terluar yang berisi seluruh kontrol. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Nilai untuk properti ini harus selalu menjadi judul yang jelas, ringkas, dan bermakna. |
| ClickablePointProperty | Lihat catatan. | Properti ini mengekspos titik yang dapat diklik dari kontrol panel yang menyebabkan panel menjadi fokus saat diklik. |
| LabeledByProperty | Lihat catatan. | Kontrol panel biasanya tidak memiliki label statik. Jika ada label teks statik, ini harus diekspos melalui properti ini. |
| ControlTypeProperty | Panel | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "panel" | String yang dilokalkan yang sesuai dengan jenis kontrol Panel. |
| IsContentElementProperty | Benar | Kontrol panel selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol panel selalu disertakan dalam tampilan kontrol pohon UI Automation. |
| HelpTextProperty | "" | Teks bantuan untuk kontrol panel harus menjelaskan mengapa tujuan bingkai dan bagaimana hubungannya dengan bingkai lain. Deskripsi diperlukan jika tujuan dan hubungan bingkai tidak jelas dari nilai NameProperty. " |
| AccessKeyProperty | Lihat catatan. | Jika kombinasi tombol tertentu memberikan fokus ke panel, informasi tersebut harus diekspos melalui properti ini. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol panel. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| ITransformProvider | Bergantung | Terapkan pola kontrol ini jika kontrol panel dapat dipindahkan, diubah ukurannya, atau diputar di layar. |
| IWindowProvider | Tidak pernah | Jika Anda perlu menerapkan pola kontrol ini, kontrol Anda harus didasarkan pada jenis kontrol Window. |
| IDockProvider | Bergantung | Terapkan pola kontrol ini jika kontrol panel dapat ditambatkan. |
| IScrollProvider | Bergantung | Terapkan pola kontrol ini jika kontrol panel dapat digulir. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang harus didukung oleh semua kontrol panel. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan/Nilai | Catatan |
|---|---|---|
| WindowClosedEvent | Tidak pernah | Tidak |
| WindowOpenedEvent | Tidak pernah | Tidak |
| AsyncContentLoadedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| HorizontallyScrollableProperty peristiwa perubahan properti. | Bergantung | Tidak |
| HorizontalScrollPercentProperty peristiwa perubahan properti. | Bergantung | Tidak |
| HorizontalViewSizeProperty peristiwa perubahan properti. | Bergantung | Tidak |
| VerticalScrollPercentProperty peristiwa perubahan properti. | Bergantung | Tidak |
| VerticallyScrollableProperty peristiwa perubahan properti. | Bergantung | Tidak |
| VerticalViewSizeProperty peristiwa perubahan properti. | Bergantung | Tidak |
| WindowVisualStateProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |
Contoh Jenis Kontrol Panel
Gambar berikut mengilustrasikan kontrol yang mengimplementasikan jenis kontrol Panel.
| Pohon Azure Automation Antarmuka Pengguna - Tampilan Kontrol | Pohon UI Automation - Tampilan Konten |
|---|---|
|
- Panel - Pohon (Pola Gulir) - TreeItem - Panel - Edit - (Pola Gulir) |