Défilement
AnnotatedScrollBar Barre de défilement annotée
Une barre de défilement avec des repères facilitant la navigation dans les longs contenus.
Exemple
Impossible de charger l'aperçu des propriétés. Sélectionnez Aperçu des propriétés pour réessayer.

Utilisation
Plage de défilement annotée avec détails
Les libellés marquent les positions notables et le fournisseur de détails résout le texte affiché au survol.
#include <FluentQt/Scrolling.h>
using namespace fluent::scrolling;
auto* bar = new AnnotatedScrollBar(this);
bar->setRange(0, 960);
bar->setPageStep(120);
bar->setLabels({
{"2023", 0, "October 2023"},
{"2022", 120, "October 2022"},
{"2021", 240, "October 2021"},
{"2020", 360, "October 2020"},
{"2019", 480, "October 2019"},
{"2018", 600, "October 2018"},
{"2017", 720, "October 2017"},
{"2016", 840, "October 2016"},
{"2015", 960, "October 2015"}
});
bar->setDetailLabelProvider([](int offset) {
const int year = 2023 - std::clamp(offset / 120, 0, 8);
return QStringLiteral("October %1").arg(year);
});import fluentqt
bar = fluentqt.AnnotatedScrollBar()
bar.setRange(0, 960)
bar.setPageStep(120)
bar.setLabels(
[
fluentqt.AnnotatedScrollBarLabel("2023", 0, "October 2023"),
fluentqt.AnnotatedScrollBarLabel("2022", 120, "October 2022"),
fluentqt.AnnotatedScrollBarLabel("2021", 240, "October 2021"),
fluentqt.AnnotatedScrollBarLabel("2020", 360, "October 2020"),
fluentqt.AnnotatedScrollBarLabel("2019", 480, "October 2019"),
fluentqt.AnnotatedScrollBarLabel("2018", 600, "October 2018"),
fluentqt.AnnotatedScrollBarLabel("2017", 720, "October 2017"),
fluentqt.AnnotatedScrollBarLabel("2016", 840, "October 2016"),
fluentqt.AnnotatedScrollBarLabel("2015", 960, "October 2015"),
]
)
def detail_for_offset(offset):
year = 2023 - max(0, min(offset // 120, 8))
return f"October {year}"
bar.setDetailLabelProvider(detail_for_offset)API
DéclarationAucun membre d'API correspondant.
fluent::scrolling::AnnotatedScrollBar
Hérite de QWidget · FluentElement · QMLPlus
Barre de défilement Fluent verticale avec libellés de section et infobulle de détail optionnelle. Peut refléter un ScrollView ou être pilotée directement via les propriétés minimum, maximum et value.
Constructeurs
Destructeurs
Méthodes
int minimum() constValeur de défilement minimale reflétée depuis le ScrollView connecté ou définie directement.
int maximum() constValeur maximale de défilement reflétée depuis la ScrollView connectée ou définie directement.
int value() constValeur de défilement actuelle qui contrôle la position du curseur et des annotations.
int pageStep() constPas de page utilisé pour le défilement ou le déplacement de plage.
QSize preferredSize() constTaille visuelle préférée du contrôle.
QSize minimumBarSize() constTaille minimale de rendu de la barre de défilement.
int verticalPadding() constMarge interne verticale à l'intérieur du contrôle.
QSize caretSize() constTaille du glyphe de chevron utilisé par les contrôles de défilement.
int labelColumnWidth() constLargeur réservée aux étiquettes annotées.
int labelLineHeight() constHauteur de ligne utilisée par les libellés annotés.
int minimumLabelSpacing() constEspacement minimal conservé entre les étiquettes visibles.
int indicatorWidth() constLargeur de la zone de l'indicateur de position de défilement.
int indicatorThickness() constÉpaisseur dessinée de l'indicateur de position de défilement.
int lineStepFallback() constPas de ligne de repli lorsqu'aucune vue déroulante connectée n'en fournit.
void setMinimum(int minimum)Valeur de défilement minimale reflétée depuis le ScrollView connecté ou définie directement.
void setMaximum(int maximum)Valeur maximale de défilement reflétée depuis la ScrollView connectée ou définie directement.
void setValue(int value)Valeur de défilement actuelle qui contrôle la position du curseur et des annotations.
void setPageStep(int pageStep)Pas de page utilisé pour le défilement ou le déplacement de plage.
void setPreferredSize(const QSize& size)Taille visuelle préférée du contrôle.
void setMinimumBarSize(const QSize& size)Taille minimale de rendu de la barre de défilement.
void setVerticalPadding(int padding)Marge interne verticale à l'intérieur du contrôle.
void setCaretSize(const QSize& size)Taille du glyphe de chevron utilisé par les contrôles de défilement.
void setLabelColumnWidth(int width)Largeur réservée aux étiquettes annotées.
void setLabelLineHeight(int height)Hauteur de ligne utilisée par les libellés annotés.
void setMinimumLabelSpacing(int spacing)Espacement minimal conservé entre les étiquettes visibles.
void setIndicatorWidth(int width)Largeur de la zone de l'indicateur de position de défilement.
void setIndicatorThickness(int thickness)Épaisseur dessinée de l'indicateur de position de défilement.
void setLineStepFallback(int step)Pas de ligne de repli lorsqu'aucune vue déroulante connectée n'en fournit.
QVector<AnnotatedScrollBarLabel> labels() constRetourne toutes les étiquettes définies, y compris celles masquées par le filtrage de collision.
void setLabels(const QVector<AnnotatedScrollBarLabel>& labels)Remplace toutes les étiquettes et invalide la mise en page des étiquettes visibles.
void setDetailLabelProvider(DetailLabelProvider provider)Définit un callback fournissant le texte détaillé d'infobulle pour un décalage de défilement survolé.
void connectToScrollView(ScrollView* scrollView)Se lie à un ScrollView pour refléter sa plage et sa valeur et lui renvoyer les requêtes de défilement.
QVector<AnnotatedScrollBarLabel> visibleLabels() constRetourne les étiquettes filtrées par collision actuellement éligibles au dessin.
Propriétés
int minimumValeur de défilement minimale reflétée depuis le ScrollView connecté ou définie directement.
Lectureminimum()ÉcrituresetMinimum()NotificationrangeChanged()int maximumValeur maximale de défilement reflétée depuis la ScrollView connectée ou définie directement.
Lecturemaximum()ÉcrituresetMaximum()NotificationrangeChanged()int valueValeur de défilement actuelle qui contrôle la position du curseur et des annotations.
Lecturevalue()ÉcrituresetValue()NotificationvalueChanged()int pageStepPas de page utilisé pour le défilement ou le déplacement de plage.
LecturepageStep()ÉcrituresetPageStep()NotificationpageStepChanged()QSize preferredSizeTaille visuelle préférée du contrôle.
LecturepreferredSize()ÉcrituresetPreferredSize()NotificationlayoutMetricsChanged()QSize minimumBarSizeTaille minimale de rendu de la barre de défilement.
LectureminimumBarSize()ÉcrituresetMinimumBarSize()NotificationlayoutMetricsChanged()int verticalPaddingMarge interne verticale à l'intérieur du contrôle.
LectureverticalPadding()ÉcrituresetVerticalPadding()NotificationlayoutMetricsChanged()QSize caretSizeTaille du glyphe de chevron utilisé par les contrôles de défilement.
LecturecaretSize()ÉcrituresetCaretSize()NotificationlayoutMetricsChanged()int labelColumnWidthLargeur réservée aux étiquettes annotées.
LecturelabelColumnWidth()ÉcrituresetLabelColumnWidth()NotificationlayoutMetricsChanged()int labelLineHeightHauteur de ligne utilisée par les libellés annotés.
LecturelabelLineHeight()ÉcrituresetLabelLineHeight()NotificationlayoutMetricsChanged()int minimumLabelSpacingEspacement minimal conservé entre les étiquettes visibles.
LectureminimumLabelSpacing()ÉcrituresetMinimumLabelSpacing()NotificationlayoutMetricsChanged()int indicatorWidthLargeur de la zone de l'indicateur de position de défilement.
LectureindicatorWidth()ÉcrituresetIndicatorWidth()NotificationlayoutMetricsChanged()int indicatorThicknessÉpaisseur dessinée de l'indicateur de position de défilement.
LectureindicatorThickness()ÉcrituresetIndicatorThickness()NotificationlayoutMetricsChanged()int lineStepFallbackPas de ligne de repli lorsqu'aucune vue déroulante connectée n'en fournit.
LecturelineStepFallback()ÉcrituresetLineStepFallback()NotificationlayoutMetricsChanged()
Signaux
void rangeChanged(int minimum, int maximum)Valeur de défilement minimale reflétée depuis le ScrollView connecté ou définie directement.
void valueChanged(int value)Valeur de défilement actuelle qui contrôle la position du curseur et des annotations.
void pageStepChanged(int pageStep)Pas de page utilisé pour le défilement ou le déplacement de plage.
void layoutMetricsChanged()Taille visuelle préférée du contrôle.
void scrollRequested(int offset)Émis lorsqu'une interaction utilisateur demande un défilement vers un décalage.
Types et alias
using DetailLabelProvider = std::function<QString(int offset)>Fonction de rappel qui résout le texte détaillé pour un décalage de défilement.
Membres protégés
Méthodes
Hérité de fluent::FluentElement
Énumérations
enum ThemeThème visuel global utilisé lors de la résolution des tokens de design.
Light = 0Dark = 1HighContrast = 2
Méthodes
static void setTheme(Theme theme)Met à jour le thème global et notifie les instances FluentElement actives.
static void setThemeDeferred(Theme theme)Planifie une actualisation par lots du thème en donnant la priorité aux éléments visibles sans bloquer l'interaction en cours.
static Theme currentTheme()Retourne le thème global actuellement actif.
static bool themeUsesDarkAppearance(Theme theme)Indique si un thème utilise un habillage à fond sombre et des jetons de matériau.
static void refreshTheme()Rediffuse le thème actuel pour redessiner après une modification de jeton de design.
static int themeGeneration()Compteur monotone incrémenté à chaque changement de thème pour la vérification d'obsolescence.
Theme effectiveTheme() constRésout le thème utilisé par cet élément, en respectant une surcharge héritée de QWidget.
bool effectiveThemeUsesDarkAppearance() constIndique si le thème effectif de cet élément utilise un habillage à fond sombre.
bool setThemeOverrides(const QJsonObject& overrides)Remplace les surcharges éparses de jetons de couleur, de rayon et de police de cet élément.
QJsonObject themeOverrides() constRenvoie les surcharges définies pour cet élément.
void clearThemeOverrides()Restaure tous les champs de tokens aux valeurs par défaut du thème global.
const Colors& themeColorsRef() constAccès sans copie au jeu de couleurs actif pour les chemins de peinture critiques.
Material::AcrylicToken themeAcrylic() constJetons de matériau, d'élévation et de mise en page adaptative.
QColor themeBackdrop(bool active) constCouleur d'arrière-plan du chrome de fenêtre pour l'état d'activation donné.
virtual void onThemeUpdated()Appelé après un changement du thème global.
Types et alias
struct ColorsInstantanés de tokens de design renvoyés aux composants.
Hérité de fluent::QMLPlus
Méthodes
AnchorLayout::Anchors* anchors()Retourne les ancres modifiables pour l'hôte QWidget.
void setState(const QString& name)Applique un état enregistré par son nom, ou restaure l'état par défaut lorsque @p name est vide. Les noms inconnus sont ignorés et les liaisons existantes reprennent à la sortie de l'état.
void addState(const QMLState& state)Enregistre ou remplace une définition d'état nommée ; remplacer l'état actif l'applique immédiatement.
void evaluateStates()Réévalue les conditions d'état dans l'ordre d'enregistrement et active la première correspondance, ou l'état par défaut si aucune ne correspond. S'exécute aussi automatiquement lorsque les propriétés dépendantes notifient ; les états dérivés utilisant extend héritent des modifications ancêtres sauf en cas de cycle ou d'absence.
QMLPlusRuntime* runtime()Retourne l'observateur d'état créé à la demande et détenu par cet hôte.
void setAnchors(const AnchorLayout::Anchors& anchors)Remplace toutes les ancres de l'hôte et invalide la mise en page parente.
void resetAnchors()Efface tous les ancrages de l'hôte et invalide la mise en page parente.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Lie @p sourceProp sur @p source à @p targetProp sur cet hôte QWidget via PropertyBinder::bind().
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Installe une liaison directe gérée sur cet hôte QWidget.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installe une expression C++ à dépendances explicites sur cet hôte QWidget.
void addTransition(const StateTransition& transition)Enregistre une transition d'état par ordre de priorité.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Définit l'animation par défaut utilisée lorsque @p propertyName est modifié via writeProperty() ou une liaison. Les règles StateTransition explicites ont la priorité ; les appels directs aux setters C++ ne sont pas animés.
void clearBehavior(const char* propertyName)Supprime l'animation par défaut pour les futures écritures gérées.
bool writeProperty(const char* propertyName, const QVariant& value)Écrit une propriété hôte via Behavior sans supprimer sa liaison.
Documentation de la classe de base Qt : QWidget
fluent::scrolling::AnnotatedScrollBarLabel
Libellé de section affiché à côté d'un décalage AnnotatedScrollBar. `offset` utilise le même espace de coordonnées de valeur de défilement que la plage de la barre ; `detailText` remplace le rappel du fournisseur de détails lorsqu'il n'est pas vide.