Fonction ShellProc
Description
Fonction de rappel définie par l’application ou définie par la bibliothèque utilisée avec la fonction SetWindowsHookExA/SetWindowsHookExW . La fonction reçoit des notifications des événements Shell du système.
Le type HOOKPROC définit un pointeur vers cette fonction de rappel. ShellProc est un espace réservé pour le nom de fonction défini par l’application ou défini par la bibliothèque.
LRESULT CALLBACK ShellProc(
_In_ int nCode,
_In_ WPARAM wParam,
_In_ LPARAM lParam
);
Paramètres
nCode [in]
Type : int
Code de hook.
Si nCode est inférieur à zéro, la procédure de crochet 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 |
|---|---|
| HSHELL_ACCESSIBILITYSTATE 11 | L’état d’accessibilité a changé. |
| HSHELL_ACTIVATESHELLWINDOW 3 | L’interpréteur de commandes doit activer sa fenêtre main. |
| HSHELL_APPCOMMAND 12 | L’utilisateur a terminé un événement d’entrée (par exemple, appuyant sur un bouton de commande d’application sur la souris ou une touche de commande d’application sur le clavier), et l’application n’a pas géré le message WM_APPCOMMAND généré par cette entrée. Si la procédure Shell gère le message WM_COMMAND , elle ne doit pas appeler CallNextHookEx. Pour plus d’informations, consultez la section Valeur de retour. |
| HSHELL_GETMINRECT 5 | Une fenêtre est réduite ou agrandie. Le système a besoin des coordonnées du rectangle réduit pour la fenêtre. |
| HSHELL_LANGUAGE 8 | La langue du clavier a été modifiée ou une nouvelle disposition du clavier a été chargée. |
| HSHELL_REDRAW 6 | Le titre d’une fenêtre dans la barre des tâches a été redessiné. |
| HSHELL_TASKMAN 7 | L’utilisateur a sélectionné la liste des tâches. Une application shell qui fournit une liste de tâches doit retourner TRUE pour empêcher Windows de démarrer sa liste de tâches. |
| HSHELL_WINDOWACTIVATED 4 | L’activation est passée à une autre fenêtre de niveau supérieur, non propriétaire. |
| HSHELL_WINDOWCREATED 1 | Une fenêtre de niveau supérieur non propriétaire a été créée. La fenêtre existe lorsque le système appelle ce crochet. |
| HSHELL_WINDOWDESTROYED 2 | Une fenêtre de niveau supérieur non propriétaire est sur le point d’être détruite. La fenêtre existe toujours lorsque le système appelle ce crochet. |
| HSHELL_WINDOWREPLACED 13 | Une fenêtre de niveau supérieur est en cours de remplacement. La fenêtre existe lorsque le système appelle ce crochet. |
wParam [in]
Type : WPARAM
Ce paramètre dépend de la valeur du paramètre nCode , comme indiqué dans le tableau suivant.
| nCode | wParam |
|---|---|
| HSHELL_ACCESSIBILITYSTATE | Indique quelle fonctionnalité d’accessibilité a changé d’état. Cette valeur est l’une des suivantes : ACCESS_FILTERKEYS, ACCESS_MOUSEKEYS ou ACCESS_STICKYKEYS. |
| HSHELL_APPCOMMAND | Indique où le message WM_APPCOMMAND a été envoyé à l’origine ; par exemple, le handle d’une fenêtre. Pour plus d’informations, consultez paramètre cmd dans WM_APPCOMMAND. |
| HSHELL_GETMINRECT | Handle de la fenêtre réduite ou agrandie. |
| HSHELL_LANGUAGE | Handle de la fenêtre. |
| HSHELL_REDRAW | Handle de la fenêtre redessinée. |
| HSHELL_WINDOWACTIVATED | Handle de la fenêtre activée. |
| HSHELL_WINDOWCREATED | Handle de la fenêtre créée. |
| HSHELL_WINDOWDESTROYED | Poignée de la fenêtre détruite. |
| HSHELL_WINDOWREPLACED | Handle de la fenêtre en cours de remplacement. Windows 2000 : non pris en charge. |
lParam [in]
Type : LPARAM
Ce paramètre dépend de la valeur du paramètre nCode , comme indiqué dans le tableau suivant.
| nCode | lParam |
|---|---|
| HSHELL_APPCOMMAND |
GET_APPCOMMAND_LPARAM(lParam) est la commande d’application correspondant à l’événement d’entrée.
GET_DEVICE_LPARAM(lParam) indique ce qui a généré l’événement d’entrée ; par exemple, la souris ou le clavier. Pour plus d’informations, consultez la description du paramètre uDevice sous WM_APPCOMMAND.
GET_FLAGS_LPARAM(lParam) dépend de la valeur cmd dans WM_APPCOMMAND. Par exemple, il peut indiquer quelles clés virtuelles ont été arrêtées lorsque le message WM_APPCOMMAND a été envoyé à l’origine. Pour plus d’informations, consultez le paramètre de description dwCmdFlags sous WM_APPCOMMAND. |
| HSHELL_GETMINRECT | Pointeur vers une structure RECT . |
| HSHELL_LANGUAGE | Poignée d’une disposition de clavier. |
| HSHELL_MONITORCHANGED | Handle de la fenêtre qui s’est déplacée vers un autre moniteur. |
| HSHELL_REDRAW | La valeur est TRUE si la fenêtre clignote, ou FALSE dans le cas contraire. |
| HSHELL_WINDOWACTIVATED | La valeur est TRUE si la fenêtre est en mode plein écran ou FALSE dans le cas contraire. |
| HSHELL_WINDOWREPLACED | Handle de la nouvelle fenêtre. Windows 2000 : non pris en charge. |
Retours
Type : LRESULT
La valeur de retour doit être égale à zéro, sauf si la valeur de nCode est HSHELL_APPCOMMAND et que la procédure d’interpréteur de commandes gère le message WM_COMMAND . Dans ce cas, le retour doit être différent de zéro.
Notes
Installez cette procédure de hook en spécifiant le type de hook WH_SHELL et un pointeur vers la procédure de hook dans un appel à la fonction SetWindowsHookEx .