Bagikan melalui

Menerapkan Pola Kontrol Dock 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 IDockProvider, termasuk informasi tentang atribut. Tautan ke referensi tambahan tercantum di akhir topik.

Pola kontrol DockPattern digunakan untuk mengekspos properti dock dari kontrol dalam wadah yang mendukung docking. Kontainer docking adalah kontrol yang memungkinkan Anda mengatur elemen turunan secara horizontal dan vertikal, relatif satu sama lain. Untuk contoh kontrol yang menerapkan pola kontrol ini, lihat Pemetaan Pola Kontrol untuk Klien Automasi UI.

Kontainer tambatan dengan dua anak yang ditambat. 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 kontainer docking atau properti kontrol apa pun yang berdekatan dengan kontrol saat ini dalam kontainer docking.

  • Elemen diposisikan relatif terhadap satu sama lain berdasarkan z-order mereka saat ini; semakin tinggi penempatan z-order mereka, semakin jauh mereka ditempatkan dari tepi wadah penambatan yang ditentukan.

  • Jika ukuran kontainer docking diubah, kontrol yang terpasang dalam kontainer akan diposisikan ulang ke tepi yang sama dengan tempat mereka awalnya dipasang. Kontrol yang didocking juga akan mengubah ukuran untuk mengisi seluruh ruang dalam kontainer sesuai dengan perilaku docking mereka DockPosition. 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 merapat ke sisi kiri atau kanan monitor yang sedang digunakan. Jika tidak memungkinkan, mereka 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 Harta benda Tidak ada
SetDockPosition Metode Tidak ada

Pola kontrol ini tidak memiliki peristiwa terkait.

Pengecualian

Penyedia harus memberikan pengecualian berikut.

Jenis pengecualian Keadaan
InvalidOperationException SetDockPosition

- Ketika kontrol tidak dapat menjalankan gaya dock yang diminta.

Lihat juga

  • Last updated on