GetScrollBarInfo, fonction (winuser.h)

Article
03/04/2024

La fonction GetScrollBarInfo récupère des informations sur la barre de défilement spécifiée.

Syntaxe

BOOL GetScrollBarInfo(
  [in]  HWND           hwnd,
  [in]  LONG           idObject,
  [out] PSCROLLBARINFO psbi
);

Paramètres

[in] hwnd

Type : HWND

Gérez une fenêtre associée à la barre de défilement dont les informations doivent être récupérées. Si le paramètre idObject est OBJID_CLIENT, hwnd est une poignée d’un contrôle de barre de défilement. Sinon, hwnd est un handle d’une fenêtre créée avec WS_VSCROLL et/ou WS_HSCROLL style.

[in] idObject

Type : LONG

Spécifie l’objet de barre de défilement. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
OBJID_CLIENT	Le paramètre hwnd est un handle d’un contrôle de barre de défilement.
OBJID_HSCROLL	Barre de défilement horizontale de la fenêtre hwnd .
OBJID_VSCROLL	Barre de défilement verticale de la fenêtre hwnd .

[out] psbi

Type : PSCROLLBARINFO

Pointeur vers une structure SCROLLBARINFO pour recevoir les informations. Avant d’appeler GetScrollBarInfo, définissez le membre cbSize sur sizeof(SCROLLBARINFO).

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 idObject est OBJID_CLIENT et que la fenêtre spécifiée par hwnd n’est pas un contrôle de barre de défilement système, le système envoie le message SBM_GETSCROLLBARINFO à la fenêtre pour obtenir des informations sur la barre de défilement. Cela permet à GetScrollBarInfo 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_GETSCROLLBARINFO , la fonction GetScrollBarInfo échoue.

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]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Composant redistribuable	Service Pack 6
Ensemble d’API	ext-ms-win-ntuser-misc-l1-2-0 (introduit dans Windows 8.1)

Voir aussi

SCROLLBARINFO

Partager via