Fungsi NotifyWinEvent (winuser.h)

Artikel
08/27/2023

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)

Lihat juga

AccessibleObjectFromEvent

SetWinEventHook

UnHookWinEvent

WinEvents

Bagikan melalui