Fonction de rappel WINEVENTPROC (winuser.h)
Fonction de rappel définie par l’application (ou hook) que le système appelle en réponse aux événements générés par un objet accessible. La fonction hook traite les notifications d’événements en fonction des besoins. Les clients installent la fonction de hook et demandent des types spécifiques de notifications d’événements en appelant SetWinEventHook.
Le type WINEVENTPROC définit un pointeur vers cette fonction de rappel. WinEventProc est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
WINEVENTPROC Wineventproc;
void Wineventproc(
HWINEVENTHOOK hWinEventHook,
DWORD event,
HWND hwnd,
LONG idObject,
LONG idChild,
DWORD idEventThread,
DWORD dwmsEventTime
)
{...}
Paramètres
hWinEventHook
Type : HWINEVENTHOOK
Gérer vers une fonction de hook d’événement. Cette valeur est retournée par SetWinEventHook lorsque la fonction de hook est installée et est spécifique à chaque instance de la fonction de hook.
event
Type : DWORD
Spécifie l’événement qui s’est produit. Cette valeur est l’une des constantes d’événement.
hwnd
Type : HWND
Gérez la fenêtre qui génère l’événement ou NULL si aucune fenêtre n’est associée à l’événement. Par exemple, le pointeur de la souris n’est pas associé à une fenêtre.
idObject
Type : LONG
Identifie l’objet associé à l’événement. Il s’agit de l’un des identificateurs d’objet ou d’un ID d’objet personnalisé.
idChild
Type : LONG
Identifie si l’événement a été déclenché par un objet ou un élément enfant de l’objet. Si cette valeur est CHILDID_SELF, l’événement a été déclenché par l’objet ; sinon, cette valeur est l’ID enfant de l’élément qui a déclenché l’événement.
idEventThread
dwmsEventTime
Type : DWORD
Spécifie l’heure, en millisecondes, pendant laquelle l’événement a été généré.
Valeur de retour
None
Remarques
Dans la fonction hook, les paramètres hwnd, idObject et idChild sont utilisés lors de l’appel d’AccessibleObjectFromEvent.
Les serveurs génèrent des événements en appelant NotifyWinEvent.
Créez plusieurs fonctions de rappel pour gérer différents événements. Pour plus d’informations, consultez Inscription d’une fonction hook.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Composant redistribuable | Active Accessibility 1.3 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 95 |