Menerapkan Pola Kontrol Beralih UI Automation
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 memperkenalkan panduan dan konvensi untuk menerapkan IWindowProvider, termasuk informasi tentang properti WindowPattern, metode, dan peristiwa. Link ke referensi tambahan tercantum di akhir topik.
Pola kontrol WindowPattern digunakan untuk mendukung kontrol yang menyediakan fungsionalitas berbasis jendela mendasar dalam antarmuka pengguna grafis (GUI) tradisional. Contoh kontrol yang harus menerapkan pola kontrol ini termasuk jendela aplikasi tingkat atas, jendela anak antarmuka multi-dokumen (MDI), kontrol panel pemisah yang dapat diubah ukurannya, dialog modal, dan jendela bantuan balon.
Pedoman dan Konvensi Implementasi
Saat menerapkan pola kontrol Toggle, perhatikan panduan dan konvensi berikut:
Untuk mendukung kemampuan memodifikasi ukuran jendela dan posisi layar menggunakan UI Automation, kontrol harus menerapkan ITransformProvider selain IWindowProvider.
Kontrol yang berisi bilah judul dan elemen bilah judul yang memungkinkan kontrol dipindahkan, diubah ukurannya, dimaksimalkan, diminimalkan, atau ditutup biasanya diperlukan untuk mengimplementasikan IWindowProvider.
Kontrol seperti pop-up tipsalat dan kotak kombo atau menu drop-down biasanya tidak mengimplementasikan IWindowProvider.
Jendela bantuan balon dibingkai dari pop-up tipsalat dasar dengan penyediaan tombol Tutup seperti jendela.
Mode layar penuh tidak didukung oleh IWindowProvider karena khusus untuk aplikasi dan bukan perilaku jendela biasa.
Anggota yang Diperlukan untuk IWindowProvider
Properti, metode, dan peristiwa berikut diperlukan untuk antarmuka IWindowProvider.
| Anggota yang diperlukan | Jenis anggota | Catatan |
|---|---|---|
| InteractionState | Properti | Tidak |
| IsModal | Properti | Tidak |
| IsTopmost | Properti | Tidak |
| Maximizable | Properti | Tidak |
| Minimizable | Properti | Tidak |
| VisualState | Properti | Tidak |
| Close | Metode | Tidak |
| SetVisualState | Metode | Tidak |
| WaitForInputIdle | Metode | Tidak |
| WindowClosedEvent | Kejadian | Tidak |
| WindowOpenedEvent | Kejadian | Tidak |
| WindowInteractionState | Kejadian | Tidak dijamin menjadi ReadyForUserInteraction |
Pengecualian
Penyedia harus menampilkan pengecualian berikut.
| Jenis pengecualian | Kondisi |
|---|---|
| InvalidOperationException | SetVisualState - Ketika kontrol tidak mendukung perilaku yang diminta. |
| ArgumentOutOfRangeException | WaitForInputIdle - Ketika parameter bukan angka yang valid. |