Fluent-Qt

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

AnnotatedScrollBar Barre de défilement annotée: Plage de défilement annotée avec détails

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);
});

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() const

Valeur de défilement minimale reflétée depuis le ScrollView connecté ou définie directement.

int maximum() const

Valeur maximale de défilement reflétée depuis la ScrollView connectée ou définie directement.

int value() const

Valeur de défilement actuelle qui contrôle la position du curseur et des annotations.

int pageStep() const

Pas de page utilisé pour le défilement ou le déplacement de plage.

QSize preferredSize() const

Taille visuelle préférée du contrôle.

QSize minimumBarSize() const

Taille minimale de rendu de la barre de défilement.

int verticalPadding() const

Marge interne verticale à l'intérieur du contrôle.

QSize caretSize() const

Taille du glyphe de chevron utilisé par les contrôles de défilement.

int labelColumnWidth() const

Largeur réservée aux étiquettes annotées.

int labelLineHeight() const

Hauteur de ligne utilisée par les libellés annotés.

int minimumLabelSpacing() const

Espacement minimal conservé entre les étiquettes visibles.

int indicatorWidth() const

Largeur 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() const

Pas 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() const

Retourne 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() const

Retourne les étiquettes filtrées par collision actuellement éligibles au dessin.

Propriétés

int minimum

Valeur de défilement minimale reflétée depuis le ScrollView connecté ou définie directement.

Lecture minimum()Écriture setMinimum()Notification rangeChanged()
int maximum

Valeur maximale de défilement reflétée depuis la ScrollView connectée ou définie directement.

Lecture maximum()Écriture setMaximum()Notification rangeChanged()
int value

Valeur de défilement actuelle qui contrôle la position du curseur et des annotations.

Lecture value()Écriture setValue()Notification valueChanged()
int pageStep

Pas de page utilisé pour le défilement ou le déplacement de plage.

Lecture pageStep()Écriture setPageStep()Notification pageStepChanged()
QSize preferredSize

Taille visuelle préférée du contrôle.

Lecture preferredSize()Écriture setPreferredSize()Notification layoutMetricsChanged()
QSize minimumBarSize

Taille minimale de rendu de la barre de défilement.

Lecture minimumBarSize()Écriture setMinimumBarSize()Notification layoutMetricsChanged()
int verticalPadding

Marge interne verticale à l'intérieur du contrôle.

Lecture verticalPadding()Écriture setVerticalPadding()Notification layoutMetricsChanged()
QSize caretSize

Taille du glyphe de chevron utilisé par les contrôles de défilement.

Lecture caretSize()Écriture setCaretSize()Notification layoutMetricsChanged()
int labelColumnWidth

Largeur réservée aux étiquettes annotées.

Lecture labelColumnWidth()Écriture setLabelColumnWidth()Notification layoutMetricsChanged()
int labelLineHeight

Hauteur de ligne utilisée par les libellés annotés.

Lecture labelLineHeight()Écriture setLabelLineHeight()Notification layoutMetricsChanged()
int minimumLabelSpacing

Espacement minimal conservé entre les étiquettes visibles.

Lecture minimumLabelSpacing()Écriture setMinimumLabelSpacing()Notification layoutMetricsChanged()
int indicatorWidth

Largeur de la zone de l'indicateur de position de défilement.

Lecture indicatorWidth()Écriture setIndicatorWidth()Notification layoutMetricsChanged()
int indicatorThickness

Épaisseur dessinée de l'indicateur de position de défilement.

Lecture indicatorThickness()Écriture setIndicatorThickness()Notification layoutMetricsChanged()
int lineStepFallback

Pas de ligne de repli lorsqu'aucune vue déroulante connectée n'en fournit.

Lecture lineStepFallback()Écriture setLineStepFallback()Notification layoutMetricsChanged()

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 Theme

Thème visuel global utilisé lors de la résolution des tokens de design.

  • Light = 0
  • Dark = 1
  • HighContrast = 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() const

Résout le thème utilisé par cet élément, en respectant une surcharge héritée de QWidget.

bool effectiveThemeUsesDarkAppearance() const

Indique 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() const

Renvoie 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() const

Accès sans copie au jeu de couleurs actif pour les chemins de peinture critiques.

Material::AcrylicToken themeAcrylic() const

Jetons de matériau, d'élévation et de mise en page adaptative.

QColor themeBackdrop(bool active) const

Couleur 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 Colors

Instantané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().

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.

Constructeurs

Champs

fluent::scrolling

Méthodes