Message WM_VSCROLL
Le message WM\_VSCROLL est envoyé à une fenêtre lorsqu’un événement de défilement se produit dans la barre de défilement vertical standard de la fenêtre. Ce message est également envoyé au propriétaire d’un contrôle de barre de défilement verticale 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_VSCROLL
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 requête de défilement de l’utilisateur. Ce paramètre peut prendre les valeurs suivantes.
Valeur Signification - SB_BOTTOM
Fait défiler vers le bas à droite. - SB_ENDSCROLL
Termine le défilement. - SB_LINEDOWN
Fait défiler une ligne vers le bas. - SB_LINEUP
Fait défiler une ligne vers le haut. - SB_PAGEDOWN
Fait défiler une page vers le bas. - SB_PAGEUP
Fait défiler une page vers le haut. - 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. - SB_TOP
Fait défiler vers le haut à gauche. -
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 requête SB_THUMBTRACK est généralement utilisé par les applications qui fournissent un commentaire 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_VSCROLL contient seulement 16 bits de données de position de la zone de défilement. Ainsi, les applications qui s’appuient seulement sur WM_H=VSCROLL (et WM_HSCROLL) 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 |
|