fonction FlatSB_SetScrollInfo (commctrl.h)

Article
02/26/2024

Définit les informations d’une barre de défilement plate. Si les barres de défilement plat ne sont pas initialisées pour la fenêtre, cette fonction appelle la fonction SetScrollInfo standard.

Syntaxe

int FlatSB_SetScrollInfo(
  HWND         unnamedParam1,
  int          code,
  LPSCROLLINFO psi,
  BOOL         fRedraw
);

Paramètres

unnamedParam1

Type : HWND

Poignée de la fenêtre qui contient la barre de défilement plate. Ce handle de fenêtre doit avoir été passé précédemment dans un appel à InitializeFlatSB.

code

Type : int

Type de barre de défilement. Ce peut être l’une des valeurs suivantes :

Valeur	Signification
SB_HORZ	Définit les informations de la barre de défilement horizontale.
SB_VERT	Définit les informations de la barre de défilement verticale.

psi

Type : LPSCROLLINFO

Pointeur vers une structure SCROLLINFO qui contient les nouvelles informations pour la barre de défilement spécifiée. Les membres cbSize et fMask de la structure doivent être renseignés avant d’appeler FlatSB_SetScrollInfo. Le membre fMask spécifie quels membres de la structure contiennent des informations valides et peuvent être n’importe quelle combinaison des valeurs suivantes :

Valeur	Signification
SIF_DISABLENOSCROLL	Désactive la barre de défilement si les nouvelles informations entraînent la suppression de la barre de défilement.
SIF_PAGE	Définit les informations de page pour la barre de défilement plat. Le membre nPage de la structure SCROLLINFO doit contenir la nouvelle valeur de page.
SIF_POS	Définit les informations de position pour la barre de défilement plat. Le membre nPos de la structure SCROLLINFO doit contenir la nouvelle valeur de position.
SIF_RANGE	Définit les informations de plage pour la barre de défilement plat. Les membres nMin et nMax de la structure SCROLLINFO doivent contenir les nouvelles valeurs de plage.
SIF_ALL	Combinaison de SIF_PAGE, SIF_POS et SIF_RANGE.

fRedraw

Type : BOOL

Spécifie si la barre de défilement doit être redessinée immédiatement pour refléter la modification. Si ce paramètre a la valeur TRUE, la barre de défilement est redessinée ; si elle est FALSE, la barre de défilement n’est pas redessinée.

Valeur retournée

Type : int

Retourne la position de défilement actuelle. Si l’appel à FlatSB_SetScrollInfo modifie la position de défilement, la position précédente est retournée.

Remarques

Note Les fonctions de barre de défilement plat sont implémentées dans Comctl32.dll versions 4.71 à 5.82. Comctl32.dll versions 6.00 et ultérieures ne prennent pas en charge les barres de défilement plates.

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	commctrl.h
Bibliothèque	Comctl32.lib
DLL	Comctl32.dll (version 4.71 ou ultérieure)

Partager via