GetScrollPos, fonction (winuser.h)

Article
08/27/2023

La fonction GetScrollPos récupère la position actuelle de la zone de défilement (pouce) dans la barre de défilement spécifiée. La position actuelle est une valeur relative qui dépend de la plage de défilement actuelle. Par exemple, si la plage de défilement est comprise entre 0 et 100 et que la zone de défilement se trouve au milieu de la barre, la position actuelle est 50.

Note La fonction GetScrollPos est fournie pour la compatibilité descendante. Les nouvelles applications doivent utiliser la fonction GetScrollInfo .

Syntaxe

int GetScrollPos(
  [in] HWND hWnd,
  [in] int  nBar
);

Paramètres

[in] hWnd

Type : HWND

Gérez vers un contrôle de barre de défilement ou une fenêtre avec une barre de défilement standard, en fonction de la valeur du paramètre nBar .

[in] nBar

Type : int

Spécifie la barre de défilement à examiner. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
SB_CTL	Récupère la position de la zone de défilement dans un contrôle de barre de défilement. Le paramètre hWnd doit être la poignée du contrôle de barre de défilement.
SB_HORZ	Récupère la position de la zone de défilement dans la barre de défilement horizontale standard d’une fenêtre.
SB_VERT	Récupère la position de la zone de défilement dans la barre de défilement verticale standard d’une fenêtre.

Valeur retournée

Type : int

Si la fonction réussit, la valeur de retour est la position actuelle de la zone de défilement.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction GetScrollPos permet aux applications d’utiliser des positions de défilement 32 bits. Bien que les messages qui indiquent la position de la barre de défilement, WM_HSCROLL et WM_VSCROLL, soient limités à 16 bits de données de position, les fonctions SetScrollPos, SetScrollRange, GetScrollPos et GetScrollRange prennent en charge les données de position de barre de défilement 32 bits. Ainsi, une application peut appeler GetScrollPos 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 , utilisez la fonction GetScrollInfo .

Si le paramètre nBar est SB_CTL et que la fenêtre spécifiée par le paramètre hWnd n’est pas un contrôle de barre de défilement système, le système envoie le message SBM_GETPOS à la fenêtre pour obtenir des informations de barre de défilement. Cela permet à GetScrollPos d’opérer sur un contrôle personnalisé qui imite une barre de défilement. Si la fenêtre ne gère pas le message SBM_GETPOS , la fonction GetScrollPos échoue.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-misc-l1-2-0 (introduit dans Windows 8.1)