Mengambil Properti dari Elemen Automation UI

Properti pada objek IUIAutomationElement berisi informasi tentang elemen UI, biasanya kontrol. Properti elemen bersifat generik; yaitu, tidak spesifik untuk jenis kontrol. Properti khusus kontrol dari elemen diekspos oleh antarmuka pola kontrolnya.

Properti Microsoft UI Automation bersifat baca-saja. Untuk mengatur properti kontrol, Anda harus menggunakan metode pola kontrol yang sesuai. Misalnya, gunakan IUIAutomationScrollPattern::Scroll untuk mengubah nilai posisi jendela gulir.

Untuk meningkatkan performa, nilai properti kontrol dan pola kontrol dapat di-cache saat elemen diambil. Untuk informasi selengkapnya, lihat Properti Automasi antarmuka pengguna penembolokan dan Pola Kontrol.

Topik ini berisi bagian berikut.

• ID Properti
• Kondisi Properti
• Mengambil Properti
• Nilai Properti Default
• Topik terkait

ID Properti

Pengidentifikasi properti didefinisikan dalam Uiautomationclient.h. Properti digunakan untuk menentukan properti saat Anda berlangganan peristiwa yang diubah properti, mengambil nilai properti, dan membuat kondisi properti. Pengidentifikasi properti juga mengidentifikasi properti yang telah berubah ketika IUIAutomationPropertyChangedEventHandler::HandlePropertyChangedEvent dipanggil.

Untuk daftar pengidentifikasi properti Automation UI, lihat Pengidentifikasi Properti.

Kondisi Properti

ID properti digunakan dalam membangun objek IUIAutomationPropertyCondition yang digunakan untuk menemukan elemen Automation UI. Misalnya, Anda mungkin ingin menemukan elemen yang memiliki nama tertentu, atau semua kontrol yang diaktifkan. Setiap kondisi properti menentukan pengidentifikasi properti dan nilai yang harus dicocokkan dengan properti.

Untuk informasi selengkapnya, lihat topik referensi berikut:

• IUIAutomation::CreatePropertyCondition
• IUIAutomation::CreatePropertyConditionEx
• IUIAutomationElement::FindFirst
• IUIAutomationElement::FindAll

Mengambil Properti

Beberapa properti generik, dan semua properti pola kontrol, tersedia sebagai properti pada antarmuka pola kontrol atau IUIAutomationElement dan dapat diambil dengan menggunakan aksesor, seperti IUIAutomationElement::CurrentName atau CachedDockPosition.

Selain itu, properti saat ini atau cache apa pun (selain properti pola kontrol) dapat diambil dengan menggunakan salah satu metode berikut:

• GetCurrentPropertyValue
• GetCurrentPropertyValueEx
• GetCachedPropertyValue
• GetCachedPropertyValueEx

Metode ini menawarkan performa dan akses yang sedikit lebih baik ke berbagai properti. Namun, nilai dikembalikan dalam struktur VARIAN , sedangkan pengakses properti individual mentransmisikan nilai ke jenis yang sesuai.

Nilai Properti Default

Jika penyedia Automation UI tidak mengimplementasikan properti, Automasi UI dapat menyediakan nilai default. Misalnya, jika penyedia untuk kontrol tidak mendukung properti yang diidentifikasi oleh UIA_HelpTextPropertyId, Otomatisasi UI mengembalikan string kosong. Demikian pula, jika penyedia tidak mendukung properti yang diidentifikasi oleh UIA_IsDockPatternAvailablePropertyId, Otomatisasi UI mengembalikan FALSE.

Perbedaan antara IUIAutomationElement::GetCurrentPropertyValue dan GetCurrentPropertyValueEx (dan antara pasangan metode serupa) adalah bahwa metode "Ex" dapat menentukan bahwa tidak ada nilai default yang akan dikembalikan. Dalam hal ini, nilai yang dikembalikan adalah konstanta unik khusus, yang menunjukkan bahwa properti tidak didukung. Pada penerimaan nilai ini, aplikasi dapat memberikan nilainya sendiri atau hanya mengabaikan properti .

Topik terkait

Konseptual

Ringkasan Properti UI Automation

Pengidentifikasi Properti