Bagikan melalui

Menerapkan Pola Kontrol Jendela Otomatisasi UI

Nota

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas Automation UI terkelola yang ditentukan dalam namespace System.Windows.Automation. Untuk informasi terbaru tentang Automasi UI, lihat Windows Automation API: UI Automation.

Topik ini memperkenalkan panduan dan konvensi untuk menerapkan IWindowProvider, termasuk informasi tentang WindowPattern properti, metode, dan peristiwa. Tautan ke referensi tambahan tercantum di akhir topik.

Pola WindowPattern kontrol digunakan untuk mendukung kontrol yang menyediakan fungsionalitas berbasis jendela dasar dalam antarmuka pengguna grafis (GUI) tradisional. Contoh kontrol yang harus menerapkan pola kontrol ini termasuk jendela aplikasi tingkat atas, jendela anak antarmuka beberapa dokumen (MDI), kontrol panel pemisah yang dapat diubah ukurannya, dialog modal, dan jendela bantuan balon.

Pedoman dan Konvensi Implementasi

Saat menerapkan pola kontrol Jendela, perhatikan panduan dan konvensi berikut:

  • Untuk mendukung kemampuan untuk memodifikasi ukuran jendela dan posisi layar menggunakan Automation UI, kontrol harus diterapkan 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 tooltip dan kotak kombo atau menu dropdown biasanya tidak mengimplementasikan IWindowProvider.

  • Jendela bantuan balon dibedakan dari popup tooltip dasar dengan adanya tombol Tutup mirip 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 Harta benda Tidak ada
IsModal Harta benda Tidak ada
IsTopmost Harta benda Tidak ada
Maximizable Harta benda Tidak ada
Minimizable Harta benda Tidak ada
VisualState Harta benda Tidak ada
Close Metode Tidak ada
SetVisualState Metode Tidak ada
WaitForInputIdle Metode Tidak ada
WindowClosedEvent Peristiwa Tidak ada
WindowOpenedEvent Peristiwa Tidak ada
WindowInteractionState Peristiwa Tidak dijamin ReadyForUserInteraction

Pengecualian

Penyedia harus memberikan pengecualian berikut.

Jenis pengecualian Keadaan
InvalidOperationException SetVisualState

- Ketika kontrol tidak mendukung perilaku yang diminta.
ArgumentOutOfRangeException WaitForInputIdle

- Ketika parameter bukan angka yang valid.

Lihat juga

  • Last updated on