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 |
|