QScrollBar Class

Description détaillée

Une barre de défilement est un contrôle qui permet à l'utilisateur d'accéder à des parties d'un document dont la taille dépasse celle du widget utilisé pour l'afficher. Elle fournit une indication visuelle de la position actuelle de l'utilisateur dans le document et de la partie du document qui est visible. Les barres de défilement sont généralement associées à d’autres contrôles permettant une navigation plus précise. Qt affiche les barres de défilement d’une manière adaptée à chaque plateforme.

Si vous devez fournir une vue défilante sur un autre widget, il peut être plus pratique d’utiliser la classe ` QScrollArea `, car celle-ci fournit un widget de fenêtre d’affichage et des barres de défilement. QScrollBar est utile si vous devez implémenter des fonctionnalités similaires pour des widgets spécialisés à l’aide de l’ QAbstractScrollArea; par exemple, si vous décidez de créer une sous-classe de QAbstractItemView. Dans la plupart des autres situations où un curseur est utilisé pour obtenir une valeur dans une plage donnée, la classe QSlider peut être plus adaptée à vos besoins.

Chaque barre de défilement possède une valeur indiquant la distance entre le curseur et le début de la barre ; cette valeur est obtenue à l’aide de ` value()` et définie à l’aide de ` setValue()`. Elle se situe toujours dans la plage de valeurs définie pour la barre de défilement, comprise entre ` minimum()` et ` maximum()`, inclus. La plage des valeurs acceptables peut être définie à l’aide de ` setMinimum()` et ` setMaximum()`. À la valeur minimale, le bord supérieur du curseur (pour une barre de défilement verticale) ou le bord gauche (pour une barre de défilement horizontale) se trouvera à l’extrémité supérieure (ou gauche) de la barre de défilement. À la valeur maximale, le bord inférieur (ou droit) du curseur se trouvera à l’extrémité inférieure (ou droite) de la barre de défilement.

La longueur du curseur est généralement liée à la valeur du pas de page et représente généralement la proportion de la zone du document affichée dans une vue défilante. Le pas de page correspond à la variation de la valeur lorsque l’utilisateur appuie sur les touches « Page Up » et « Page Down » ; il est défini à l’aide de la fonction ` setPageStep()`. Des modifications plus fines de la valeur, définies par le pas de ligne, sont effectuées à l’aide des touches de curseur ; cette valeur est définie à l’aide de la fonction ` setSingleStep()`.

Notez que la plage de valeurs utilisée est indépendante de la taille réelle du widget de la barre de défilement. Vous n’avez pas besoin d’en tenir compte lorsque vous choisissez les valeurs de la plage et du pas de page.

La plage de valeurs spécifiée pour la barre de défilement est souvent déterminée différemment de celle d’un « QSlider », car la longueur du curseur doit être prise en compte. Si nous avons un document de 100 lignes et que nous ne pouvons afficher que 20 lignes dans un widget, nous pouvons souhaiter créer une barre de défilement avec un pas de page de 20, une valeur minimale de 0 et une valeur maximale de 80. Nous obtiendrions ainsi une barre de défilement comportant cinq « pages ».

La relation entre la longueur d’un document, la plage de valeurs utilisée dans une barre de défilement et le pas de page est simple dans de nombreuses situations courantes. La plage de valeurs de la barre de défilement est déterminée en soustrayant un pas de page choisi d’une valeur représentant la longueur du document. Dans de tels cas, l’équation suivante est utile : longueur du document = maximum() - minimum() + pageStep().

QScrollBar ne fournit que des plages d’entiers. Notez que bien que QScrollBar gère des nombres très grands, les barres de défilement sur les écrans actuels ne peuvent pas représenter de manière utile des plages supérieures à environ 100 000 pixels. Au-delà de cette limite, il devient difficile pour l’utilisateur de contrôler le curseur à l’aide du clavier ou de la souris, et les flèches de défilement n’auront qu’une utilité limitée.

ScrollBar hérite d’un ensemble complet de signaux de QAbstractSlider:

• valueChanged() est émis lorsque la valeur de la barre de défilement a changé. La propriété tracking détermine si ce signal est émis lors d'une interaction de l'utilisateur.
• rangeChanged() est émis lorsque la plage de valeurs de la barre de défilement a changé.
• sliderPressed() est émis lorsque l’utilisateur commence à faire glisser le curseur.
• sliderMoved() est émis lorsque l'utilisateur fait glisser le curseur.
• sliderReleased() est émis lorsque l'utilisateur relâche le curseur.
• actionTriggered() est émis lorsque la barre de défilement est modifiée par une interaction de l'utilisateur ou via la fonction triggerAction().

Une barre de défilement peut être contrôlée à l’aide du clavier, mais sa valeur par défaut pour ` focusPolicy()` est ` Qt::NoFocus`. Utilisez ` setFocusPolicy()` pour activer l’interaction au clavier avec la barre de défilement :

• Gauche/Droite : déplace une barre de défilement horizontale d’un seul pas.
• Les touches Haut/Bas déplacent une barre de défilement verticale d’un pas.
• PageUp permet de remonter d’une page.
• PageDown permet de descendre d’une page.
• « Home » permet d'accéder au début (minimum).
• Fin : se déplace jusqu'à la fin (maximum).

Le curseur lui-même peut être contrôlé à l'aide de la fonction triggerAction() pour simuler l'interaction de l'utilisateur avec les commandes de la barre de défilement. Cela s'avère utile si vous disposez de nombreux widgets différents utilisant une plage de valeurs commune.

La plupart des styles d'interface graphique utilisent la valeur de ` pageStep()` pour calculer la taille du curseur.