Fonction de rappel WINEVENTPROC (winuser.h)

  • Article

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

Voir aussi

SetWinEventHook