Tipe Kontrol Hyperlink

Topik ini menyediakan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol Hyperlink.

Kontrol hyperlink membuat tautan yang memungkinkan pengguna menavigasi dalam halaman yang sama, atau dari satu halaman ke halaman lainnya.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Hyperlink. Persyaratan Automasi UI berlaku untuk semua kontrol hyperlink tempat kerangka kerja/platform UI mengintegrasikan dukungan Automation UI untuk jenis kontrol dan pola kontrol.

Topik ini berisi bagian berikut.

• Struktur Pohon Umum
• properti yang relevan
• Pola Kontrol yang Diperlukan
• Peristiwa yang Diperlukan
• Komentar
• Topik terkait

Struktur Pohon Umum

Tabel berikut ini menggambarkan kontrol umum dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol hyperlink dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI .

Tampilan Kontrol	Tampilan Isi
Hyperlink	Hyperlink

 

Properti yang Relevan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol hyperlink. Untuk informasi selengkapnya tentang properti Automation UI, lihat Mengambil Properti dari Elemen Automation UI.

Properti Automasi UI	Nilai	Catatan
UIA_AutomationIdPropertyId	Lihat catatan.	Nilai properti ini harus unik di semua kontrol dalam aplikasi.
UIA_BoundingRectanglePropertyId	Lihat catatan.	Persegi panjang terluar yang berisi seluruh kontrol.
UIA_ClickablePointPropertyId	Lihat catatan.	Titik yang dapat diklik kontrol hyperlink harus merupakan titik yang meluncurkan hyperlink jika diklik dengan penunjuk mouse.
UIA_ControlTypePropertyId	Hyperlink
UIA_IsContentElementPropertyId	BENAR	Kontrol hyperlink selalu disertakan dalam tampilan konten pohon Automation UI.
UIA_IsControlElementPropertyId	BENAR	Kontrol hyperlink selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_IsKeyboardFocusablePropertyId	Lihat catatan.	Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
UIA_LabeledByPropertyId	Lihat catatan.	Jika ada label teks statis, properti ini harus mengekspos referensi ke kontrol tersebut.
UIA_LocalizedControlTypePropertyId	Lihat catatan.	String yang dilokalkan sesuai dengan jenis kontrol Hyperlink. Nilai defaultnya adalah "hyperlink" untuk en-US atau Inggris (Amerika Serikat).
UIA_NamePropertyId	Lihat catatan.	Nama kontrol hyperlink adalah teks yang ditampilkan di layar seperti yang digarisbawaahkan.

 

Pola Kontrol yang Diperlukan

Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan kontrol hyperlink untuk didukung. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI .

Properti Pola/Pola Kontrol	Dukungan/Nilai	Catatan
IInvokeProvider	Diperlukan	Semua kontrol hyperlink harus mendukung pola kontrol Invoke.
IValueProvider	Tergantung	Kontrol hyperlink harus mendukung pola kontrol Nilai saat tautan berisi informasi yang dapat digunakan dan bermakna bagi pengguna.
Nilai	Misalnya, "https://www..."	URL untuk alamat Internet atau intranet adalah contoh hyperlink yang berisi informasi yang bermakna bagi pengguna. Namun, tautan terprogram hanya bermakna untuk aplikasi dan tidak direkomendasikan untuk properti Nilai.

 

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan kontrol hyperlink untuk didukung. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .

Peristiwa Automasi UI	Catatan
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti.
UIA_Invoke_InvokedEventId
UIA_IsEnabledPropertyId peristiwa yang diubah properti.	Jika kontrol mendukung propertiIsEnabled, kontrol harus mendukung peristiwa ini.
UIA_IsOffscreenPropertyId peristiwa yang diubah properti.	Jika kontrol mendukung propertiIsOffscreen, kontrol harus mendukung peristiwa ini.
UIA_StructureChangedEventId

 

Komentar

Tipe kontrol Hyperlink harus diterapkan hanya ke objek yang, saat diklik, menyebabkan navigasi terjadi; tidak boleh diterapkan ke kontainer hyperlink. Misalnya, hanya "hot spot" yang dapat diklik di dalam peta gambar yang harus memiliki jenis kontrol Hyperlink. Hal yang sama berlaku untuk hyperlink dalam bidang teks atau kontainer dokumen. Dalam hal ini, hanya teks atau gambar hyperlink yang harus memiliki jenis kontrol Hyperlink, bukan kontainer.

Pola kontrol Teks sangat ideal untuk mendukung hyperlink yang disematkan dalam elemen teks atau dokumen.

Topik terkait

Konseptual

Gambaran Umum Tipe Kontrol Automasi UI

Gambaran Umum Automasi UI