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	Winuser.h (y compris Windows.h)

Voir aussi

Référence

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL (Trackbar)