Message WM_HSCROLL

  • Article

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

Voir aussi

Référence

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL (barre de suivi)

WM_VSCROLL