Fungsi NotifyWinEvent (winuser.h)
Menandakan sistem bahwa peristiwa yang telah ditentukan sebelumnya terjadi. Jika ada aplikasi klien yang telah mendaftarkan fungsi hook untuk peristiwa tersebut, sistem memanggil fungsi hook klien.
Sintaks
void NotifyWinEvent(
[in] DWORD event,
[in] HWND hwnd,
[in] LONG idObject,
[in] LONG idChild
);
Parameter
[in] event
Jenis: DWORD
Menentukan peristiwa yang terjadi. Nilai ini harus menjadi salah satu konstanta peristiwa.
[in] hwnd
Jenis: HWND
Tangani ke jendela yang berisi objek yang menghasilkan peristiwa.
[in] idObject
Jenis: LONG
Mengidentifikasi objek yang menghasilkan peristiwa. Nilai ini adalah salah satu pengidentifikasi objek yang telah ditentukan sebelumnya atau nilai ID objek kustom.
[in] idChild
Jenis: LONG
Mengidentifikasi apakah peristiwa dihasilkan oleh objek atau oleh elemen anak objek. Jika nilai ini CHILDID_SELF, peristiwa dihasilkan oleh objek itu sendiri. Jika tidak CHILDID_SELF, nilai ini adalah ID anak dari elemen yang menghasilkan peristiwa.
Nilai kembali
Tidak ada
Keterangan
Server memanggil fungsi ini untuk memberi tahu sistem bahwa suatu peristiwa telah terjadi. Microsoft Active Accessibility memeriksa untuk melihat apakah ada aplikasi klien yang telah menetapkan prosedur kait untuk peristiwa tersebut dan, jika demikian, memanggil prosedur kait yang sesuai.
Jika tidak ada prosedur kait yang terdaftar untuk peristiwa tersebut, penalti performa untuk memanggil fungsi ini adalah kecil.
Server memanggil NotifyWinEvent untuk mengumumkan peristiwa ke sistem setelah peristiwa terjadi; mereka tidak boleh memberi tahu sistem peristiwa sebelum peristiwa terjadi.
Ketika prosedur kait klien dipanggil, ia menerima sejumlah parameter yang menjelaskan peristiwa dan objek yang menghasilkan peristiwa. Prosedur kait menggunakan fungsi AccessibleObjectFromEvent untuk mengambil pointer ke antarmuka IAccessible objek yang menghasilkan peristiwa.
Server mungkin menerima pesan WM_GETOBJECT segera setelah memanggil fungsi ini. Ini dapat terjadi jika ada klien dalam konteks yang memanggil AccessibleObjectFromEvent dalam panggilan balik peristiwa.
Ketika server memanggil fungsi ini, mereka harus siap untuk menangani WM_GETOBJECT, mengembalikan penunjuk antarmuka IAccessible , dan menangani salah satu metode IAccessible .
Catatan untuk Pengembang Server: Saat Anda memanggil NotifyWinEvent, jika ada klien yang mendengarkan peristiwa tersebut dalam konteks, penanganan aktivitas mereka, yang biasanya mengirim WM_GETOBJECT dan memanggil metode IAccessible , akan dijalankan sebelum NotifyWinEvent kembali. Ketika Anda memanggil NotifyWinEvent, Anda harus siap untuk menangani panggilan ini, jika itu terjadi. Jika Anda perlu melakukan penyiapan ekstra untuk memungkinkan hal ini, Anda harus melakukannya sebelum memanggil NotifyWinEvent, bukan setelahnya.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winuser.h (termasuk Windows.h) |
Pustaka | User32.lib |
DLL | User32.dll |
Redistribusi | Aksesibilitas Aktif 1.3 RDK pada Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 95 |
Set API | ext-ms-win-ntuser-server-l1-1-0 (diperkenalkan dalam Windows 8) |