Gambaran Umum Jenis Kontrol UI Automation

  • Artikel

Jenis kontrol Microsoft UI Automation adalah properti yang berfungsi sebagai pengidentifikasi terkenal yang menunjukkan jenis kontrol yang diwakili elemen UI tertentu, seperti kotak kombo atau tombol. Aplikasi klien menggunakan jenis untuk mengidentifikasi kemampuan kontrol dan menentukan cara berinteraksi dengannya.

Topik ini berisi bagian berikut:

Persyaratan Jenis Kontrol UI Automation

Setiap jenis kontrol Automation UI memiliki serangkaian kondisi yang terkait dengannya. Ketika penyedia menetapkan jenis kontrol ke kontrol, penyedia harus memastikan bahwa kontrol memenuhi semua kondisi yang terkait dengan jenis kontrol tersebut. Kondisinya meliputi hal-hal berikut:

  • Pola kontrol Automation UI: Setiap jenis kontrol memiliki serangkaian pola kontrol yang harus didukung kontrol, set yang opsional, dan set yang tidak boleh didukung kontrol.
  • Nilai properti Automation UI: Setiap jenis kontrol memiliki sekumpulan properti yang harus didukung kontrol.
  • Peristiwa Automasi UI: Setiap jenis kontrol memiliki serangkaian peristiwa yang harus didukung kontrol.
  • Struktur pohon Automation UI: Setiap jenis kontrol menentukan bagaimana kontrol harus muncul dalam struktur pohon Automation UI.

Ketika kontrol memenuhi kondisi untuk jenis kontrol tertentu, nilai properti IUIAutomationElement::CurrentControlType (atau IUIAutomationElement::CachedControlType) akan menunjukkan jenis kontrol tersebut.

Jika kontrol Anda tidak memenuhi spesifikasi untuk jenis kontrol tertentu, gunakan UIA_CustomControlTypeId sebagai ID jenis kontrol, dan jelaskan sepenuhnya kontrol dengan menggunakan pola dan properti kontrol yang relevan. Anda juga dapat mengatur properti UIA_LocalizedControlTypePropertyId ke string yang paling tepat menggambarkan jenis kontrol Anda.

Properti LocalizedControlType

Jika Anda menggunakan jenis kontrol yang telah ditentukan sebelumnya untuk menjelaskan kontrol Anda, gunakan nilai default untuk properti UIA_LocalizedControlTypePropertyId dan izinkan Automasi UI untuk menyediakan string yang dilokalkan agar penyedia dapat mengekspos dengan benar. Jika Anda tidak dapat menggunakan jenis kontrol yang telah ditentukan sebelumnya untuk menjelaskan kontrol Anda, atur properti UIA_LocalizedControlTypePropertyId ke string yang dilokalkan yang secara akurat menjelaskan jenis kontrol Anda. String harus ringkas, namun cukup akurat sehingga teknologi bantuan seperti pembaca layar dapat menggunakannya di UI untuk memberi tahu pengguna tentang jenis kontrol.

Jenis Kontrol UI Automation Saat Ini

Topik berikut menjelaskan jenis kontrol Automation UI. Untuk setiap jenis kontrol, deskripsi menyertakan serangkaian kondisi yang harus didukung oleh kontrol jenis tertentu:

Referensi

Pengidentifikasi Tipe Kontrol

Konseptual

Mendukung Jenis Kontrol Automasi UI

Dukungan UI Automation untuk Kontrol Standar

Dasar-Dasar UI Automation