Dukungan UI Automation untuk Jenis Kontrol Ibu Jari
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 memberikan informasi tentang dukungan UI Automation untuk jenis kontrol Ibu Jari. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.
Kontrol ibu jari menyediakan fungsi yang mengaktifkan kontrol dipindahkan (atau diseret), seperti tombol bilah gulir, atau diubah ukurannya, seperti widget mengubah ukuran jendela. Kontrol ibu jari juga dapat diterapkan sebagai batas panel yang dapat dipindahkan. Perhatikan bahwa kontrol tersebut tidak menyediakan fungsi seret dan letakkan. Kontrol ibu jari dapat menerima fokus mouse tetapi biasanya tidak fokus pada keyboard. Pengembang kontrol harus menerapkan kontrol sehingga bertindak dengan tepat (dapat diseret atau diubah ukurannya).
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol Ibu Jari. Persyaratan UI Automation berlaku untuk semua kontrol ibu jari, baik Windows Presentation Foundation (WPF), Win32, maupun Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol ibu jari dan menjelaskan yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Ibu Jari | - Tidak berlaku |
Kontrol ibu jari tidak pernah muncul di Tampilan Konten karena hanya ada untuk dimanipulasi dengan mouse. Fungsinya diekspos melalui pola kontrol lain, seperti Pola Gulir, Pola Transformasi, atau Pola RangeValue, didukung pada kontainer Ibu Jari.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilainya atau definisinya sangat relevan dengan kontrol ibu jari. Untuk informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AutomationIdProperty | Lihat catatan. | Nilai properti ini harus unik di semua kontrol dalam aplikasi. |
| BoundingRectangleProperty | Lihat catatan. | Persegi terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Titik apa pun dalam area klien yang terlihat dari kontrol Ibu Jari. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Null |
Kontrol Ibu Jari tidak tersedia di Tampilan Konten pohon UI Automation sehingga tidak memerlukan nama. |
| LabeledByProperty | Null |
Kontrol ibu jari tidak pernah memiliki label. |
| ControlTypeProperty | Ibu Jari | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | “ibu jari” | String yang dilokalkan sesuai dengan jenis kontrol Ibu Jari. |
| IsContentElementProperty | Salah | Kontrol Ibu Jari tidak pernah berupa konten. |
| IsControlElementProperty | Benar | Kontrol Ibu Jari harus selalu menjadi kontrol. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol ibu jari. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol/Properti Pola | Dukungan/Nilai | Catatan |
|---|---|---|
| ITransformProvider | Wajib | Mengaktifkan kontrol ibu jari untuk dipindahkan pada layar. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol ibu jari. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |