Vue d'ensemble des contrôles HScrollBar et VScrollBar (Windows Forms)
Mise à jour : novembre 2007
Les contrôles ScrollBar Windows Forms permettent une navigation facile dans une longue liste d'éléments ou un important volume d'informations en les faisant défiler horizontalement ou verticalement dans une application ou un contrôle. Les barres de défilement sont un élément courant de l'interface Windows. De ce fait, le contrôle ScrollBar est souvent utilisé avec les contrôles qui ne sont pas dérivés de la classe ScrollableControl. De la même manière, de nombreux développeurs choisissent d'incorporer le contrôle ScrollBar lors de la création de leurs propres contrôles utilisateur.
Les contrôles HScrollBar (horizontaux) et VScrollBar (verticaux) fonctionnent indépendamment d'autres contrôles et ont leurs propres jeux d'événements, de propriétés et de méthodes. Les contrôles ScrollBar ne sont pas les mêmes que les barres de défilement intégrées attachées aux zones de texte, zones de liste, zones de liste déroulante ou formulaires MDI (le contrôle TextBox possède une propriété ScrollBars permettant d'afficher ou de masquer les barres de défilement attachées au contrôle).
Les contrôles ScrollBar utilisent l'événement Scroll pour surveiller le mouvement de la case de défilement (parfois appelée le curseur) le long de la barre de défilement. L'utilisation de l'événement Scroll permet d'avoir accès à la valeur de la barre de défilement au moment même où la case de défilement est déplacée.
Value, propriété
La propriété Value (qui a par défaut la valeur 0) est une valeur integer correspondant à la position de la case de défilement dans la barre de défilement. Lorsque la position de la case de défilement est à sa valeur minimale, la case de défilement se place le plus à gauche (pour les barres de défilement horizontal) ou tout en haut (pour les barres de défilement vertical). Lorsque la position de la case de défilement est à sa valeur maximale, cette dernière se place le plus à droite ou tout en bas. De la même manière, une valeur à mi-chemin entre les valeurs minimale et maximale place le bord de tête de la case de défilement au milieu de la barre de défilement.
Pour changer la valeur de la barre de défilement, l'utilisateur peut non seulement utiliser les clics de souris, mais aussi faire glisser la case de défilement à tout emplacement le long de la barre. La valeur qui en résulte dépend de la position de la case de défilement, mais elle se situe toujours dans la plage des propriétés Minimum aux propriétés Maximum définies par l'utilisateur.
Propriétés LargeChange et SmallChange
Lorsque l'utilisateur appuie sur la touche PG. PRÉC ou PG. SUIV, ou clique dans la barre de défilement d'un côté ou de l'autre de la case de défilement, la propriété Value change en fonction de la valeur définie dans la propriété LargeChange.
Lorsque l'utilisateur appuie sur l'une des touches de direction ou clique sur l'un des boutons de la barre de défilement, la propriété Value change en fonction de la valeur définie dans la propriété SmallChange.
Voir aussi
Concepts
Ajouts dans les Windows Forms pour .NET Framework 2.0