MouseProc fonction)

Description

Fonction de rappel définie par l’application ou définie par la Bibliothèque utilisée avec la fonction SetWindowsHookEx . Le système appelle cette fonction chaque fois qu’une application appelle la fonction GetMessage ou PeekMessage et qu’un message de souris est traité.

Le type HOOKPROC définit un pointeur vers cette fonction de rappel. MouseProc est un espace réservé pour le nom de la fonction définie par l’application ou par la bibliothèque.

LRESULT CALLBACK MouseProc(
  _In_ int    nCode,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

Paramètres

nCode [in]

Type : int

Code que la procédure de raccordement utilise pour déterminer comment traiter le message. Si nCode est inférieur à zéro, la procédure de raccordement doit passer le message à la fonction CallNextHookEx sans traitement supplémentaire et doit retourner la valeur retournée par CallNextHookEx. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
HC_ACTION 0 Les paramètres wParam et lParam contiennent des informations sur un message de souris.
HC_NOREMOVE 3 Les paramètres wParam et lParam contiennent des informations sur un message de souris, et le message de la souris n’a pas été supprimé de la file d’attente de messages. (Une application appelée fonction PeekMessage , en spécifiant l’indicateur PM_NOREMOVE .)

wParam [in]

Type : wParam

Identificateur du message de la souris.

lParam [in]

Type : lParam

Pointeur vers une structure MOUSEHOOKSTRUCT .

Retours

Type : LRESULT

Si nCode est inférieur à zéro, la procédure de raccordement doit retourner la valeur retournée par CallNextHookEx.

Si nCode est supérieur ou égal à zéro et que la procédure de hook n’a pas traité le message, il est vivement recommandé d’appeler CallNextHookEx et de retourner la valeur qu’il retourne ; dans le cas contraire, les autres applications qui ont installé WH_MOUSE hooks ne recevront pas de notifications de raccordement et pourront se comporter de manière incorrecte. Si la procédure de Hook a traité le message, elle peut retourner une valeur différente de zéro pour empêcher le système de transmettre le message à la procédure de fenêtre cible.

Remarques

Une application installe la procédure de raccordement en spécifiant le type de hook WH_MOUSE et un pointeur vers la procédure de Hook dans un appel à la fonction SetWindowsHookEx .

La procédure de raccordement ne doit pas installer de WH_JOURNALPLAYBACK fonction de rappel.

Ce hook peut être appelé dans le contexte du thread qui l’a installé. L’appel est effectué en envoyant un message au thread qui a installé le hook. Par conséquent, le thread qui a installé le hook doit avoir une boucle de message.

Voir aussi

CallNextHookEx

GetMessage

MOUSEHOOKSTRUCT

PeekMessage

SetWindowsHookEx

Hooks

À propos des hooks