Partager via


SBM_SETSCROLLINFO message

Le message SBM_SETSCROLLINFO est envoyé pour définir les paramètres d’une barre de défilement.

Les applications ne doivent pas envoyer ce message directement. Au lieu de cela, ils doivent utiliser la fonction SetScrollInfo . Une fenêtre reçoit ce message via sa fonction WindowProc. Les applications qui implémentent un contrôle de barre de défilement personnalisé doivent répondre à ces messages pour que la fonction SetScrollInfo fonctionne correctement.

Paramètres

wParam

Spécifie si la barre de défilement est redessinée pour refléter la nouvelle position de la zone de défilement. Si ce paramètre a la valeur TRUE, la barre de défilement est redessinée. Si elle a la valeur FALSE, la barre de défilement n’est pas redessinée.

lParam

Pointeur vers une structure SCROLLINFO . Avant d’appeler SetScrollInfo, définissez le membre cbSize de la structure sur sizeof(SCROLLINFO), définissez le membre fMask pour indiquer les paramètres à définir et spécifiez les nouvelles valeurs de paramètre dans les membres appropriés.

Le membre fMask peut être une ou plusieurs des valeurs suivantes.

Valeur Signification
SIF_DISABLENOSCROLL
Désactive la barre de défilement au lieu de la supprimer, si les nouveaux paramètres de la barre de défilement rendent la barre de défilement inutile.
SIF_PAGE
Définit la page de défilement sur la valeur spécifiée dans le membre nPage .
SIF_POS
Définit la position de défilement sur la valeur spécifiée dans le membre nPos .
SIF_RANGE
Définit la plage de défilement sur la valeur spécifiée dans les membres nMin et nMax .

Valeur retournée

La valeur de retour est la position actuelle de la zone de défilement.

Remarques

Les messages qui indiquent la position de la barre de défilement, WM_HSCROLL et WM_VSCROLL fournissent uniquement 16 bits de données de position. Toutefois, la structure SCROLLINFO utilisée par SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo et SetScrollInfo fournit 32 bits de données de position de la barre de défilement. Vous pouvez utiliser ces messages et fonctions lors du traitement des messages WM_HSCROLL ou WM_VSCROLL pour obtenir des données de position de barre de défilement 32 bits.

Configuration requise

Condition requise Valeur
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 (include Windows.h)

Voir aussi

Référence

GetScrollInfo

SBM_GETSCROLLINFO

SCROLLINFO

SetScrollInfo