WINEVENTPROC-Rückruffunktion (winuser.h)
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 |