SBM_GETSCROLLINFO message

Le message SBM_GETSCROLLINFO est envoyé pour récupérer 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 GetScrollInfo . 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 GetScrollInfo fonctionne correctement.

Paramètres

wParam

Ce paramètre n'est pas utilisé.

lParam

Pointeur vers une structure SCROLLINFO . Avant d’appeler GetScrollInfo, définissez le membre cbSize de la structure sur sizeof (SCROLLINFO) et définissez le membre fMask pour spécifier les paramètres de la barre de défilement à récupérer. Avant de retourner, le message copie les paramètres spécifiés dans les membres appropriés de la structure.

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

Valeur	Signification
SIF_ALL	Combinaison de SIF_PAGE, SIF_POS, SIF_RANGE et SIF_TRACKPOS.
SIF_PAGE	Copie la page de défilement dans le membre nPage.
SIF_POS	Copie la position de défilement vers le membre nPos.
SIF_RANGE	Copie la plage de défilement vers les membres nMin et nMax.
SIF_TRACKPOS	Copie la position de suivi de la zone de défilement actuelle dans le membre nTrackPos.

Valeur retournée

Si le message a récupéré des valeurs, la valeur renvoyée est TRUE ; sinon, elle est FALSE.

Remarques

Les messages qui indiquent la position de la barre de défilement, WM_HSCROLL et WM_VSCROLL fournissent seulement 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 la barre de défilement 32 bits.

Pour obtenir la position 32 bits de la zone de défilement (pouce) pendant une SB_THUMBTRACK code de requête dans un message WM_HSCROLL ou WM_VSCROLL , envoyez SBM_GETSCROLLINFO avec la valeur SIF_TRACKPOS dans le membre fMask de la structure SCROLLINFO . Le message retourne la position de suivi de la zone de défilement dans le membre nTrackPos de la structure SCROLLINFO . Cela vous permet d’obtenir la position de la zone de défilement à mesure que l’utilisateur la déplace. Vous pouvez également utiliser la fonction GetScrollInfo pour obtenir les mêmes informations.

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_SETSCROLLINFO

SCROLLINFO

SetScrollInfo