WINEVENTPROC-Rückruffunktion (winuser.h)

  • Artikel

Eine anwendungsdefinierte Rückruffunktion (oder Hookfunktion), die das System als Reaktion auf Ereignisse aufruft, die von einem barrierefreien Objekt generiert werden. Die Hookfunktion verarbeitet die Ereignisbenachrichtigungen nach Bedarf. Clients installieren die Hookfunktion und fordern bestimmte Arten von Ereignisbenachrichtigungen an, indem Sie SetWinEventHook aufrufen.

Der WINEVENTPROC-Typ definiert einen Zeiger auf diese Rückruffunktion. WinEventProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

WINEVENTPROC Wineventproc;

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

Parameter

hWinEventHook

Typ: HWINEVENTHOOK

Handle für eine Ereignishookfunktion. Dieser Wert wird von SetWinEventHook zurückgegeben, wenn die Hookfunktion installiert wird und für jeden instance der Hookfunktion spezifisch ist.

event

Typ: DWORD

Gibt das aufgetretene Ereignis an. Dieser Wert ist eine der Ereigniskonstanten.

hwnd

Typ: HWND

Handle für das Fenster, das das Ereignis generiert, oder NULL , wenn dem Ereignis kein Fenster zugeordnet ist. Der Mauszeiger ist beispielsweise keinem Fenster zugeordnet.

idObject

Typ: LONG

Identifiziert das objekt, das dem Ereignis zugeordnet ist. Dies ist einer der Objektbezeichner oder eine benutzerdefinierte Objekt-ID.

idChild

Typ: LONG

Gibt an, ob das Ereignis von einem -Objekt oder einem untergeordneten Element des -Objekts ausgelöst wurde. Wenn dieser Wert CHILDID_SELF ist, wurde das Ereignis vom -Objekt ausgelöst. Andernfalls ist dieser Wert die untergeordnete ID des Elements, das das Ereignis ausgelöst hat.

idEventThread

dwmsEventTime

Typ: DWORD

Gibt die Zeit in Millisekunden an, zu der das Ereignis generiert wurde.

Rückgabewert

Keine

Bemerkungen

Innerhalb der Hook-Funktion werden die Parameter hwnd, idObject und idChild verwendet, wenn AccessibleObjectFromEvent aufgerufen wird.

Server generieren Ereignisse durch Aufrufen von NotifyWinEvent.

Erstellen Sie mehrere Rückruffunktionen, um verschiedene Ereignisse zu behandeln. Weitere Informationen finden Sie unter Registrieren einer Hook-Funktion.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Verteilbare Komponente Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95

Weitere Informationen

SetWinEventHook