Menerapkan Pola Kontrol Dock 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 penerapan IDockProvider, termasuk informasi tentang properti. Link ke referensi tambahan tercantum di akhir topik.
Pola kontrol DockPattern digunakan untuk mengekspos properti dock dari kontrol dalam kontainer dok. Kontainer dock adalah kontrol yang memungkinkan Anda mengatur elemen turunan secara horizontal dan vertikal, relatif terhadap satu sama lain. Untuk contoh kontrol yang menerapkan pola kontrol ini, baca Pemetaan Pola Kontrol untuk Klien UI Automation.
Contoh Docking dari Visual Studio Tempat Jendela "Tampilan Kelas" Adalah DockPosition.Right dan Jendela "Daftar Kesalahan" Adalah DockPosition.Bottom
Pedoman dan Konvensi Implementasi
Saat menerapkan pola kontrol Dock, perhatikan panduan dan konvensi berikut:
IDockProvider tidak mengekspos properti apa pun dari kontainer dock atau properti kontrol apa pun yang berdekatan dengan kontrol saat ini di dalam kontainer dok.
Kontrol di-dock relatif satu sama lain berdasarkan urutan-z saat ini; semakin tinggi penempatan z-order mereka, semakin jauh mereka ditempatkan dari tepi tertentu dari kontainer docking.
Jika kontainer docking diubah ukurannya, kontrol apa pun yang di-dock di dalam kontainer akan diposisikan ulang ke tepi yang sama dengan yang awalnya di-dock. Kontrol yang di-dock juga akan diubah ukurannya untuk mengisi ruang apa pun di dalam kontainer sesuai dengan perilaku docking DockPosition mereka. Misalnya, jika Top ditentukan, sisi kiri dan kanan kontrol akan diperluas untuk mengisi ruang yang tersedia. Jika Fill ditentukan, keempat sisi kontrol akan diperluas untuk mengisi ruang yang tersedia.
Pada sistem multi-monitor, kontrol harus di-dock di sisi kiri atau kanan monitor saat ini. Jika tidak memungkinkan, kontrol harus merapat ke sisi kiri monitor paling kiri atau sisi kanan monitor paling kanan.
Anggota yang Diperlukan untuk IDockProvider
Properti dan metode berikut diperlukan untuk menerapkan antarmuka IDockProvider.
| Anggota yang diperlukan | Jenis anggota | Catatan |
|---|---|---|
| DockPosition | Properti | Tidak |
| SetDockPosition | Metode | Tidak |
Pola kontrol ini tidak memiliki peristiwa terkait.
Pengecualian
Penyedia harus menampilkan pengecualian berikut.
| Jenis pengecualian | Kondisi |
|---|---|
| InvalidOperationException | SetDockPosition - Saat kontrol tidak dapat menjalankan gaya dock yang diminta. |