Dukungan UI Automation untuk Jenis Kontrol Jendela
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 Window. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.
Kontrol jendela terdiri atas bingkai jendela, yang memuat objek elemen turunan seperti bilah judul, klien, dan objek lainnya.
Persyaratan UI Automation di bagian berikut berlaku untuk semua kontrol yang menerapkan jenis kontrol Jendela, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol jendela dan menjelaskan yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Jendela | Jendela |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol jendela. Untuk mendapatkan 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. |
| ClickablePointProperty | Lihat catatan. | Kontrol jendela harus memiliki titik yang dapat diklik yang akan mengakibatkan jendela dipilih atau tidak dipilih. |
| ControlTypeProperty | Jendela | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Benar | Kontrol jendela harus selalu memiliki konten. |
| IsControlElementProperty | Benar | Kontrol jendela harus selalu memiliki kontrol. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| LabeledByProperty | null |
Kontrol jendela tidak memiliki label Jendela statik. |
| LocalizedControlTypeProperty | “window” | String yang dilokalkan sesuai dengan jenis kontrol Jendela. |
| NameProperty | Lihat catatan. | Kontrol jendela selalu memuat elemen Jendela utama yang berkaitan dengan yang akan dikaitkan pengguna sebagai pengidentifikasi paling semantik untuk item tersebut. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol jendela. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IDockProvider | Kondisional | Harus didukung jika jendela memiliki kemampuan untuk ditambatkan. |
| ITransformProvider | Wajib | Mengaktifkan jendela dipindahkan, diubah ukurannya, atau diputar pada layar. |
| IWindowProvider | Wajib | Mengaktifkan operasi tertentu untuk jendela. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol jendela. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AsyncContentLoadedEvent | Wajib | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| LayoutInvalidatedEvent | Wajib | Tidak |
| NameProperty peristiwa perubahan properti. | Wajib | Tidak |
| StructureChangedEvent | 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 |
| WindowClosedEvent | Wajib | Tidak |
| WindowOpenedEvent | Wajib | Tidak |
| WindowVisualStateProperty peristiwa perubahan properti. | Bergantung | Tidak |