Fluent-Qt

Vues de collection

StackView Vue empilée

Un conteneur en pile qui empile et dépile des pages avec des transitions.

Exemple

StackView Vue empilée: Empiler et dépiler des pages

Utilisation

Empiler et dépiler des pages

StackView gère une pile de navigation de pages avec des transitions.

#include <FluentQt/Collections.h>
using namespace fluent::collections;

auto* stackView = new StackView(this);
stackView->setInitialItem(firstPage);
stackView->push(nextPage);
stackView->pop();
QObject::connect(stackView, &StackView::depthChanged,
                 status, updateStatus);

fluent::collections::StackView

Hérite de QStackedWidget · FluentElement · QMLPlus

Conteneur de pages empilées avec navigation push/pop et transitions animées. Étend QStackedWidget avec une pile de navigation, des animations de transition et une libération WidgetOwnership par page.

Constructeurs

Destructeurs

Énumérations

enum class StackViewItemStatus
  • Inactive
  • Activating
  • Active
  • Deactivating
enum class StackViewTransitionType
  • SlideFade
  • ScaleFade
  • Immediate

Méthodes

int depth() const

Nombre de pages actuellement dans la pile.

QWidget* currentItem() const

Page de pile actuellement visible.

QWidget* initialItem() const

Page initiale insérée dans la pile.

bool busy() const

Indique si une opération de transition ou de navigation est en cours.

Qt::Orientation orientation() const

Orientation principale de la disposition ou du mouvement.

void setOrientation(Qt::Orientation orientation)

Orientation principale de la disposition ou du mouvement.

bool transitionAnimationEnabled() const

Indique si l'animation de transition de pile est activée.

void setTransitionAnimationEnabled(bool enabled)

Indique si l'animation de transition de pile est activée.

int transitionDuration() const

Durée de transition de la pile en millisecondes.

void setTransitionDuration(int durationMs)

Durée de transition de la pile en millisecondes.

StackViewTransitionType transitionType() const

Effet de transition utilisé pour la navigation en pile.

void setTransitionType(StackViewTransitionType type)

Effet de transition utilisé pour la navigation en pile.

WidgetOwnership defaultItemOwnership() const

Mode de libération par défaut pour les pages ajoutées via les API de StackView.

void setDefaultItemOwnership(WidgetOwnership ownership)

Mode de libération par défaut pour les pages ajoutées via les API de StackView.

void setInitialItem(QWidget* item)

Page initiale insérée dans la pile.

bool adoptWidget(QWidget* item, WidgetOwnership ownership = WidgetOwnership::Borrowed)

Enregistre un widget enfant existant dans la pile de navigation (géré par l'appelant par défaut, WidgetOwnership::Borrowed).

Propriétés

int depth

Nombre de pages actuellement dans la pile.

Lecture depth()Notification depthChanged()
QWidget* currentItem

Page de pile actuellement visible.

Lecture currentItem()Notification currentItemChanged()
QWidget* initialItem

Page initiale insérée dans la pile.

Lecture initialItem()Écriture setInitialItem()Notification initialItemChanged()
bool busy

Indique si une opération de transition ou de navigation est en cours.

Lecture busy()Notification busyChanged()
Qt::Orientation orientation

Orientation principale de la disposition ou du mouvement.

Lecture orientation()Écriture setOrientation()Notification orientationChanged()
bool transitionAnimationEnabled

Indique si l'animation de transition de pile est activée.

Lecture transitionAnimationEnabled()Écriture setTransitionAnimationEnabled()Notification transitionAnimationEnabledChanged()
int transitionDuration

Durée de transition de la pile en millisecondes.

Lecture transitionDuration()Écriture setTransitionDuration()Notification transitionDurationChanged()
StackViewTransitionType transitionType

Effet de transition utilisé pour la navigation en pile.

Lecture transitionType()Écriture setTransitionType()Notification transitionTypeChanged()
fluent::WidgetOwnership defaultItemOwnership

Mode de libération par défaut pour les pages ajoutées via les API de StackView.

Lecture defaultItemOwnership()Écriture setDefaultItemOwnership()Notification defaultItemOwnershipChanged()

Signaux

void depthChanged(int depth)

Nombre de pages actuellement dans la pile.

void currentItemChanged(QWidget* item)

Page de pile actuellement visible.

void initialItemChanged(QWidget* item)

Page initiale insérée dans la pile.

void busyChanged(bool busy)

Indique si une opération de transition ou de navigation est en cours.

void orientationChanged(Qt::Orientation orientation)

Orientation principale de la disposition ou du mouvement.

void transitionAnimationEnabledChanged(bool enabled)

Indique si l'animation de transition de pile est activée.

void transitionDurationChanged(int durationMs)

Durée de transition de la pile en millisecondes.

void transitionTypeChanged(StackViewTransitionType type)

Effet de transition utilisé pour la navigation en pile.

void defaultItemOwnershipChanged(WidgetOwnership ownership)

Mode de libération par défaut pour les pages ajoutées via les API de StackView.

Ajouts PySide6

setInitialOwnedItem(page)

Réinitialise la pile avec une page dont elle prend possession. Passez None pour vider la pile.

setInitialBorrowedItem(page)

Réinitialise la pile avec une page qui se retrouve sans parent à son retrait.

setInitialReparentedItem(page)

Réinitialise la pile avec une page qui retrouvera son parent d’origine à son retrait.

pushOwnedItem(page)

Empile une page et en transfère la propriété à la pile.

pushBorrowedItem(page)

Empile une page qui se retrouve sans parent lorsqu’on la dépile.

pushReparentedItem(page)

Empile une page qui retrouvera son parent d’origine lorsqu’on la dépile.

pushOwnedItems(pages)

Empile plusieurs pages en une seule transition native et en transfère la propriété à la pile.

pushBorrowedItems(pages)

Empile plusieurs pages qui se retrouvent sans parent à leur retrait.

pushReparentedItems(pages)

Empile plusieurs pages qui retrouveront chacune leur parent d’origine à leur retrait.

replaceOwnedItem(page)

Remplace la page courante par une page dont la pile prend possession.

replaceBorrowedItem(page)

Remplace la page courante par une page empruntée.

replaceReparentedItem(page)

Remplace la page courante par une page qui retrouvera son parent d’origine à son retrait.

replaceOwnedItemAt(index, page)

Remplace la page à la position index par une page dont la pile prend possession.

replaceBorrowedItemAt(index, page)

Remplace la page à la position index par une page empruntée.

replaceReparentedItemAt(index, page)

Remplace la page à la position index par une page qui retrouvera son parent d’origine à son retrait.

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 : QStackedWidget