GetScrollRange, fonction (winuser.h)

Article
03/15/2023

La fonction GetScrollRange récupère les positions de zone de défilement (pouce) minimales et maximales actuelles pour la barre de défilement spécifiée.

Note La fonction GetScrollRange est fournie à des fins de compatibilité uniquement. Les nouvelles applications doivent utiliser la fonction GetScrollInfo .

Syntaxe

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

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 à partir de laquelle les positions sont récupérées. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
SB_CTL	Récupère les positions d’un contrôle de barre de défilement. Le paramètre hWnd doit être le handle du contrôle de barre de défilement.
SB_HORZ	Récupère les positions de la barre de défilement horizontale standard de la fenêtre.
SB_VERT	Récupère les positions de la barre de défilement verticale standard de la fenêtre.

[out] lpMinPos

Type : LPINT

Pointeur vers la variable entière qui reçoit la position minimale.

[out] lpMaxPos

Type : LPINT

Pointeur vers la variable entière qui reçoit la position maximale.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

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

Si la fenêtre spécifiée n’a pas de barres de défilement standard ou n’est pas un contrôle de barre de défilement, la fonction GetScrollRange copie zéro dans les paramètres lpMinPos et lpMaxPos .

La plage par défaut d’une barre de défilement standard est comprise entre 0 et 100. La plage par défaut d’un contrôle de barre de défilement est vide (les deux valeurs sont égales à zéro).

Les messages qui indiquent la position de la barre de défilement, WM_HSCROLL et WM_VSCROLL, sont limités à 16 bits de données de position. Toutefois, étant donné que SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos et GetScrollRange prennent en charge les données de position de la barre de défilement 32 bits, il existe un moyen de contourner la barrière 16 bits des messages WM_HSCROLL et WM_VSCROLL . Consultez la fonction GetScrollInfo pour obtenir une description de la technique.

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_GETRANGE à la fenêtre pour obtenir des informations sur la barre de défilement. Cela permet à GetScrollRange de fonctionner sur un contrôle personnalisé qui imite une barre de défilement. Si la fenêtre ne gère pas le message SBM_GETRANGE , la fonction GetScrollRange é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