Fungsi panggilan balik WINEVENTPROC (winuser.h)
Fungsi panggilan balik (atau hook) yang ditentukan aplikasi yang dipanggil sistem sebagai respons terhadap peristiwa yang dihasilkan oleh objek yang dapat diakses. Fungsi hook memproses pemberitahuan peristiwa sesuai kebutuhan. Klien menginstal fungsi hook dan meminta jenis pemberitahuan peristiwa tertentu dengan memanggil SetWinEventHook.
Jenis WINEVENTPROC mendefinisikan penunjuk ke fungsi panggilan balik ini. WinEventProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.
Sintaks
WINEVENTPROC Wineventproc;
void Wineventproc(
HWINEVENTHOOK hWinEventHook,
DWORD event,
HWND hwnd,
LONG idObject,
LONG idChild,
DWORD idEventThread,
DWORD dwmsEventTime
)
{...}
Parameter
hWinEventHook
Jenis: HWINEVENTHOOK
Menangani ke fungsi hook peristiwa. Nilai ini dikembalikan oleh SetWinEventHook ketika fungsi hook diinstal dan khusus untuk setiap instans fungsi hook.
event
Jenis: DWORD
Menentukan peristiwa yang terjadi. Nilai ini adalah salah satu konstanta peristiwa.
hwnd
Jenis: HWND
Tangani ke jendela yang menghasilkan peristiwa, atau NULL jika tidak ada jendela yang terkait dengan peristiwa. Misalnya, penunjuk mouse tidak terkait dengan jendela.
idObject
Jenis: LONG
Mengidentifikasi objek yang terkait dengan peristiwa. Ini adalah salah satu pengidentifikasi objek atau ID objek kustom.
idChild
Jenis: LONG
Mengidentifikasi apakah peristiwa dipicu oleh objek atau elemen turunan objek. Jika nilai ini CHILDID_SELF, peristiwa dipicu oleh objek ; jika tidak, nilai ini adalah ID anak dari elemen yang memicu peristiwa.
idEventThread
dwmsEventTime
Jenis: DWORD
Menentukan waktu, dalam milidetik, bahwa peristiwa dihasilkan.
Nilai kembali
Tidak ada
Keterangan
Dalam fungsi hook, parameter hwnd, idObject, dan idChild digunakan saat memanggil AccessibleObjectFromEvent.
Server menghasilkan peristiwa dengan memanggil NotifyWinEvent.
Buat beberapa fungsi panggilan balik untuk menangani peristiwa yang berbeda. Untuk informasi selengkapnya, lihat Mendaftarkan Fungsi Hook.
Persyaratan
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) |
Redistribusi | Aksesibilitas Aktif 1.3 RDK pada Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 95 |