Funzione di callback WINEVENTPROC (winuser.h)

Articolo
03/15/2023

Funzione di callback (o hook) definita dall'applicazione che il sistema chiama in risposta agli eventi generati da un oggetto accessibile. La funzione hook elabora le notifiche degli eventi in base alle esigenze. I client installano la funzione hook e richiedono tipi specifici di notifiche degli eventi chiamando SetWinEventHook.

Il tipo WINEVENTPROC definisce un puntatore a questa funzione di callback. WinEventProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

WINEVENTPROC Wineventproc;

void Wineventproc(
  HWINEVENTHOOK hWinEventHook,
  DWORD event,
  HWND hwnd,
  LONG idObject,
  LONG idChild,
  DWORD idEventThread,
  DWORD dwmsEventTime
)
{...}

Parametri

hWinEventHook

Tipo: HWINEVENTHOOK

Handle per una funzione hook di eventi. Questo valore viene restituito da SetWinEventHook quando la funzione hook è installata ed è specifica per ogni istanza della funzione hook.

event

Tipo: DWORD

Specifica l'evento che si è verificato. Questo valore è una delle costanti dell'evento.

hwnd

Tipo: HWND

Gestire la finestra che genera l'evento o NULL se all'evento non è associata alcuna finestra. Ad esempio, il puntatore del mouse non è associato a una finestra.

idObject

Tipo: LONG

Identifica l'oggetto associato all'evento. Si tratta di uno degli identificatori di oggetto o di un ID oggetto personalizzato.

idChild

Tipo: LONG

Identifica se l'evento è stato attivato da un oggetto o da un elemento figlio dell'oggetto . Se questo valore è CHILDID_SELF, l'evento è stato attivato dall'oggetto ; in caso contrario, questo valore è l'ID figlio dell'elemento che ha attivato l'evento.

idEventThread

dwmsEventTime

Tipo: DWORD

Specifica il tempo, espresso in millisecondi, in cui è stato generato l'evento.

Valore restituito

nessuno

Osservazioni

All'interno della funzione hook, i parametri hwnd, idObject e idChild vengono usati quando si chiama AccessibleObjectFromEvent.

I server generano eventi chiamando NotifyWinEvent.

Creare più funzioni di callback per gestire eventi diversi. Per altre informazioni, vedere Registrazione di una funzione hook.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Componente ridistribuibile	Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95

Vedi anche

SetWinEventHook

Condividi tramite