Message WM_HSCROLL
Le message WM\_HSCROLL est envoyé à une fenêtre quand un événement de défilement se produit dans la barre de défilement horizontale standard de la fenêtre. Ce message est également envoyé au propriétaire d’un contrôle de barre de défilement horizontale quand un événement de défilement se produit dans le contrôle.
Une fenêtre reçoit ce message à travers sa fonction WindowProc.
WM_HSCROLL
WPARAM wParam
LPARAM lParam;
Paramètres
-
wParam
-
Le HIWORD spécifie la position actuelle de la zone de défilement si le LOWORD est SB_THUMBPOSITION ou SB_THUMBTRACK ; sinon, ce mot n’est pas utilisé.
Le LOWORD spécifie une valeur de barre de défilement qui indique la demande de défilement de l’utilisateur. Ce mot peut avoir une des valeurs suivantes.
Valeur Signification - SB_ENDSCROLL
Termine le défilement. - SB_LEFT
Fait défiler vers le haut à gauche. - SB_RIGHT
Fait défiler vers le bas à droite. - SB_LINELEFT
Fait défiler d’une unité vers la gauche. - SB_LINERIGHT
Fait défiler d’une unité vers la droite. - SB_PAGELEFT
Fait défiler de la largeur de la fenêtre vers la gauche. - SB_PAGERIGHT
Fait défiler de la largeur de la fenêtre vers la droite. - SB_THUMBPOSITION
L’utilisateur a fait glisser la zone de défilement (le curseur) et a relâché le bouton de la souris. Le HIWORD indique la position de la zone de défilement à la fin de l’opération de glissement. - SB_THUMBTRACK
L’utilisateur fait glisser la case de défilement. Ce message est envoyé de façon répétée jusqu’à ce que l’utilisateur relâche le bouton de la souris. Le HIWORD indique la position à laquelle la zone de défilement a été déplacée. -
lParam
-
Si le message est envoyé par un contrôle de barre de défilement, ce paramètre est le handle du contrôle de barre de défilement. Si le message est envoyé par une barre de défilement standard, ce paramètre a la valeur NULL.
Valeur retournée
Si une application traite ce message, elle doit retourner à zéro.
Notes
Le code de demande SB_THUMBTRACK est généralement utilisé par les applications qui fournissent un feedback quand l’utilisateur fait glisser la zone de défilement.
Si une application fait défiler le contenu de la fenêtre, elle doit également réinitialiser la position de la zone de défilement en utilisant la fonction SetScrollPos.
Notez que le message WM_HSCROLL contient seulement 16 bits de données de position de la zone de défilement. Ainsi, les applications qui s’appuient seulement sur WM_HSCROLL (et WM_VSCROLL) pour les données de position du défilement ont une valeur de position maximale pratique de 65 535.
Cependant, comme les fonctions SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos et GetScrollRange prennent en charge les données de position de barre de défilement sur 32 bits, il existe un moyen de contourner la barrière de 16 bits des messages WM_HSCROLL et WM_VSCROLL. Consultez GetScrollInfo pour obtenir une description de la technique.
Spécifications
| Condition requise | Value |
|---|---|
| Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| En-tête |
|