Scroll Bar

Cette section contient des informations sur les éléments de programmation utilisés avec les barres de défilement. Une fenêtre peut afficher un objet de données, tel qu’un document ou une bitmap, qui est plus grand que la zone cliente de la fenêtre. Lorsqu’une barre de défilement est fournie, l’utilisateur peut faire défiler un objet de données dans la zone cliente pour afficher les parties de l’objet qui s’étendent au-delà des bordures de la fenêtre.

Vues d'ensemble

Rubrique	Contenu
À propos des barres de défilement	Une barre de défilement se compose d’un axe ombré avec un bouton de flèche à chaque extrémité et une zone de défilement (parfois appelée pouce) entre les boutons de flèche.
Utilisation des barres de défilement	Lors de la création d’une fenêtre contextuelle ou enfant superposée, vous pouvez ajouter des barres de défilement standard à l’aide de la fonction CreateWindowEx et en spécifiant WS_HSCROLL, WS_VSCROLL ou les deux styles.

Fonctions

Rubrique	Contenu
EnableScrollBar	La fonction EnableScrollBar active ou désactive une ou les deux flèches de barre de défilement.
GetScrollBarInfo	La fonction GetScrollBarInfo récupère des informations sur la barre de défilement spécifiée.
GetScrollInfo	La fonction GetScrollInfo récupère les paramètres d’une barre de défilement, notamment les positions de défilement minimales et maximales, la taille de la page et la position de la zone de défilement (pouce).
GetScrollPos	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 .
GetScrollRange	La fonction GetScrollRange récupère les positions de zone de défilement minimale et maximale (pouce) 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 .
ScrollDC	La fonction ScrollDC fait défiler un rectangle de bits horizontalement et verticalement.
ScrollWindow	La fonction ScrollWindow fait défiler le contenu de la zone cliente de la fenêtre spécifiée. Note: La fonction ScrollWindow est fournie pour la compatibilité descendante. Les nouvelles applications doivent utiliser la fonction ScrollWindowEx .
ScrollWindowEx	La fonction ScrollWindowEx fait défiler le contenu de la zone cliente de la fenêtre spécifiée.
SetScrollInfo	La fonction SetScrollInfo définit les paramètres d’une barre de défilement, notamment les positions de défilement minimales et maximales, la taille de la page et la position de la zone de défilement (pouce). La fonction redessine également la barre de défilement, si nécessaire.
SetScrollPos	La fonction SetScrollPos définit la position de la zone de défilement (pouce) dans la barre de défilement spécifiée et, si nécessaire, redessine la barre de défilement pour refléter la nouvelle position de la zone de défilement. Note: La fonction SetScrollPos est fournie pour la compatibilité descendante. Les nouvelles applications doivent utiliser la fonction SetScrollInfo .
SetScrollRange	La fonction SetScrollRange définit les positions de zone de défilement minimales et maximales pour la barre de défilement spécifiée. Note: La fonction SetScrollRange est fournie pour la compatibilité descendante. Les nouvelles applications doivent utiliser la fonction SetScrollInfo .
ShowScrollBar	La fonction ShowScrollBar affiche ou masque la barre de défilement spécifiée.

Messages

Rubrique	Contenu
SBM_ENABLE_ARROWS	Une application envoie le message SBM_ENABLE_ARROWS pour activer ou désactiver une ou les deux flèches d’un contrôle de barre de défilement.
SBM_GETPOS	Le message SBM_GETPOS est envoyé pour récupérer la position actuelle de la zone de défilement d’un contrôle de barre de défilement. 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. Les applications ne doivent pas envoyer ce message directement. Au lieu de cela, ils doivent utiliser la fonction GetScrollPos . 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 GetScrollPos fonctionne correctement.
SBM_GETRANGE	Le message SBM_GETRANGE est envoyé pour récupérer les valeurs de position minimale et maximale pour le contrôle de barre de défilement. Les applications ne doivent pas envoyer ce message directement. Au lieu de cela, ils doivent utiliser la fonction GetScrollRange . 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 GetScrollRange fonctionne correctement.
SBM_GETSCROLLBARINFO	Envoyé par une application pour récupérer des informations sur la barre de défilement spécifiée.
SBM_GETSCROLLINFO	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.
SBM_SETPOS	Le message SBM_SETPOS est envoyé pour définir la position de la zone de défilement (pouce) et, si demandé, redessiner la barre de défilement pour refléter la nouvelle position de la zone de défilement. Les applications ne doivent pas envoyer ce message directement. Au lieu de cela, ils doivent utiliser la fonction SetScrollPos . 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 SetScrollPos fonctionne correctement.
SBM_SETRANGE	Le message SBM_SETRANGE est envoyé pour définir les valeurs de position minimale et maximale pour le contrôle de barre de défilement. Les applications ne doivent pas envoyer ce message directement. Au lieu de cela, ils doivent utiliser la fonction SetScrollRange . 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 SetScrollRange fonctionne correctement.
SBM_SETRANGEREDRAW	Une application envoie le message SBM_SETRANGEREDRAW à un contrôle de barre de défilement pour définir les valeurs de position minimale et maximale et pour redessiner le contrôle.
SBM_SETSCROLLINFO	Le message SBM_SETSCROLLINFO est envoyé pour définir 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 SetScrollInfo . 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 SetScrollInfo fonctionne correctement.

Notifications

Rubrique	Contenu
WM_CTLCOLORSCROLLBAR	Le message WM_CTLCOLORSCROLLBAR est envoyé à la fenêtre parente d’un contrôle de barre de défilement lorsque le contrôle est sur le point d’être dessiné. En répondant à ce message, la fenêtre parente peut utiliser le handle de contexte d’affichage pour définir la couleur d’arrière-plan du contrôle de barre de défilement. Une fenêtre reçoit ce message via sa fonction WindowProc.
WM_HSCROLL	Le message WM_HSCROLL est envoyé à une fenêtre lorsqu’un événement de défilement se produit dans la barre de défilement horizontale standard de la fenêtre. Ce message est également envoyé au propriétaire d’un contrôle de barre de défilement horizontale lorsqu’un événement de défilement se produit dans le contrôle. Une fenêtre reçoit ce message via sa fonction WindowProc.
WM_VSCROLL	Le message WM_VSCROLL est envoyé à une fenêtre lorsqu’un événement de défilement se produit dans la barre de défilement verticale standard de la fenêtre. Ce message est également envoyé au propriétaire d’un contrôle de barre de défilement verticale lorsqu’un événement de défilement se produit dans le contrôle. Une fenêtre reçoit ce message via sa fonction WindowProc.

Structures

Rubrique	Contenu
SCROLLBARINFO	La structure SCROLLBARINFO contient des informations de barre de défilement.
SCROLLINFO	La structure SCROLLINFO contient des paramètres de barre de défilement à définir par la fonction SetScrollInfo (ou SBM_SETSCROLLINFO message), ou récupérés par la fonction GetScrollInfo (ou SBM_GETSCROLLINFO message).

Constantes

Rubrique

Contenu

Styles de contrôle de barre de défilement

Pour créer un contrôle de barre de défilement à l’aide de la fonction CreateWindow ou CreateWindowEx , spécifiez la classe SCROLLBAR, les constantes de style de fenêtre appropriées et une combinaison des styles de contrôle de barre de défilement suivants. Certains styles créent un contrôle de barre de défilement qui utilise une largeur ou une hauteur par défaut. Toutefois, vous devez toujours spécifier les coordonnées x et y et les autres dimensions de la barre de défilement lorsque vous appelez CreateWindow ou CreateWindowEx.