Bagikan melalui

Penerapan Pola Kontrol Transformasi Otomatisasi Antarmuka Pengguna

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 ITransformProvider, termasuk informasi tentang properti, metode, dan peristiwa. Tautan ke referensi tambahan tercantum di akhir topik.

Pola TransformPattern kontrol digunakan untuk mendukung kontrol yang dapat dipindahkan, diubah ukurannya, atau diputar dalam ruang dua dimensi. Untuk contoh kontrol yang menerapkan pola kontrol ini, lihat Pemetaan Pola Kontrol untuk Klien Automasi UI.

Pedoman dan Konvensi Implementasi

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

  • Dukungan untuk pola kontrol ini tidak terbatas pada objek pada desktop. Pola kontrol ini juga harus didukung oleh anak-anak objek kontainer jika anak-anak bisa dipindahkan, diubah ukurannya, atau diputar secara bebas dalam batas kontainer.

  • Objek tidak dapat dipindahkan, diubah ukurannya, atau diputar sehingga lokasi layar yang dihasilkan akan sepenuhnya berada di luar koordinat kontainernya dan oleh karena itu tidak dapat diakses ke keyboard atau mouse (misalnya, ketika jendela tingkat atas dipindahkan di luar layar atau objek anak dipindahkan di luar batas viewport kontainer). Dalam kasus ini, objek ditempatkan sedekat mungkin dengan koordinat layar yang diminta, sementara koordinat atas atau kiri disesuaikan agar berada dalam batas kontainer.

  • Untuk sistem multi-monitor, jika objek dipindahkan, diubah ukurannya, atau diputar sepenuhnya di luar koordinat layar desktop gabungan, objek ditempatkan pada monitor utama sedekat mungkin dengan koordinat yang diminta.

  • Semua parameter dan nilai properti bersifat absolut dan tidak bergantung pada lokalisasi.

Anggota yang Diperlukan untuk ITransformProvider

Properti dan metode berikut diperlukan untuk menerapkan ITransformProvider.

Anggota yang diperlukan Jenis anggota Catatan
CanMove Harta benda Tidak ada
CanResize Harta benda Tidak ada
CanRotate Harta benda Tidak ada
Move Metode Tidak ada
Resize Metode Tidak ada
Rotate Metode Tidak ada

Pola kontrol ini tidak memiliki peristiwa terkait.

Pengecualian

Penyedia harus memberikan pengecualian berikut.

Tipe Pengecualian Keadaan
InvalidOperationException Move

- Jika CanMoveProperty salah.
InvalidOperationException Resize

- Jika CanResizeProperty salah.
InvalidOperationException Rotate

- Jika CanRotateProperty salah.

Lihat juga

  • Last updated on