Bagikan melalui

Gambaran Umum Tipe Kontrol Automasi UI

  • 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 untuk menentukan cara berinteraksi dengannya.

Topik ini berisi bagian berikut:

Persyaratan Tipe Kontrol Automasi UI

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 yang berikut ini:

  • Pola kontrol Otomasi Antarmuka Pengguna: Setiap jenis kontrol memiliki serangkaian pola kontrol yang harus didukung oleh kontrol, kumpulan yang bersifat opsional, dan kumpulan yang tidak boleh didukung oleh kontrol.
  • Nilai properti UI Automation: Setiap jenis kontrol memiliki sekumpulan properti yang harus didukung oleh kontrol tersebut.
  • 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 di 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 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 Automasi UI Saat Ini

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

Referensi

Pengidentifikasi Jenis Kontrol

Konseptual

Mendukung Tipe Kontrol Automasi UI

Dukungan Otomasi UI untuk Kontrol Standar

Dasar-Dasar Automasi UI