Mendapatkan Penunjuk Antarmuka Objek yang Dapat Diakses

Aplikasi klien Microsoft Active Accessibility mengambil penunjuk antarmuka ke objek yang dapat diakses dengan menggunakan salah satu fungsi berikut.

AccessibleObjectFromEvent

Banyak klien mencari informasi tentang objek tertentu yang dapat diakses yang menghasilkan peristiwa. Karena antarmuka IAccessible adalah "gateway" untuk objek yang dapat diakses, klien harus memiliki cara mudah untuk mengaitkan WinEvents dengan antarmuka IAccessible objek yang menghasilkan peristiwa. Microsoft Active Accessibility menyediakan fungsi AccessibleObjectFromEvent khusus untuk tujuan ini.

Nota

Klien dengan fungsi hook dalam konteks harus memanggil fungsi IsWindow sebelum memanggil AccessibleObjectFromEvent.

 

Fungsi AccessibleObjectFromEvent menerima banyak informasi yang sama dengan yang diterima fungsi hook klien. Saat fungsi kait klien menerima pemberitahuan peristiwa, fungsi ini meneruskan parameter yang sesuai dari peristiwa ke AccessibleObjectFromEvent.

Fungsi ini mengambil antarmuka IAccessible dari elemen antarmuka pengguna yang menghasilkan peristiwa atau antarmuka objek induk elemen. Jika penunjuk antarmuka objek induk dikembalikan, klien memanggil properti dan metode induk untuk mendapatkan informasi tentang elemen anak yang menghasilkan peristiwa.

AccessibleObjectFromPoint

Untuk mengambil alamat antarmuka IAccessible objek pada titik tertentu di layar, klien menggunakan fungsi AccessibleObjectFromPoint .

AccessibleObjectFromWindow

Untuk mendapatkan antarmuka IAccessible objek dari handle jendela, klien menggunakan fungsi AccessibleObjectFromWindow.

Ada kemungkinan bahwa server mengembalikan penunjuk antarmuka yang berbeda untuk elemen antarmuka pengguna yang sama setiap kali fungsi AccessibleObjectFromEvent, AccessibleObjectFromPoint, atau AccessibleObjectFromWindow dipanggil. Untuk menentukan apakah dua pointer merujuk ke elemen antarmuka pengguna yang sama, pengembang klien harus membandingkan properti IAccessible objek, bukan pointer.