Dukungan UI Automation untuk Jenis Kontrol Hyperlink
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 Hyperlink. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
Kontrol hyperlink memungkinkan pengguna untuk menavigasi dalam halaman, dari satu halaman ke halaman lain, dan membuka jendela.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol Hyperlink. Persyaratan UI Automation berlaku untuk semua kontrol hyperlink, 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 hyperlink dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Hyperlink | Hyperlink |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan jenis kontrol Hyperlink. 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. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam kotak pembatas dapat diklik, dan Anda melakukan pengujian hit khusus, maka ambil alih dan berikan titik yang dapat diklik. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Nama kontrol hyperlink adalah teks yang ditampilkan di layar seperti yang digarisbawahi. |
| ClickablePointProperty | Lihat catatan. | Titik yang dapat diklik kontrol hyperlink harus menjadi titik yang meluncurkan hyperlink jika diklik dengan pointer mouse. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statik, properti ini harus mengekspos referensi ke kontrol tersebut. |
| ControlTypeProperty | Hyperlink | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "hyperlink" | String lokal yang sesuai dengan jenis kontrol Hyperlink. |
| IsContentElementProperty | Benar | Kontrol hyperlink selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol hyperlink selalu disertakan dalam tampilan kontrol pohon UI Automation. |
Pola dan Properti Kontrol UI Automation yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol hyperlink. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol/Properti Pola | Dukungan/Nilai | Catatan |
|---|---|---|
| IInvokeProvider | Ya | Semua kontrol hyperlink harus mendukung pola Panggil. |
| IValueProvider | Bergantung | Kontrol hyperlink harus mendukung pola kontrol Nilai ketika link berisi informasi yang dapat digunakan dan bermakna bagi pengguna. |
| Value | Misalnya: "https://www...." |
URL untuk alamat Internet atau Intranet adalah contoh hyperlink yang berisi informasi yang berarti bagi pengguna. Namun, link terprogram hanya bermakna bagi aplikasi dan tidak direkomendasikan untuk properti Nilai. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol hyperlink. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| InvokedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |