Vues de collection
StackView Vue empilée
Un conteneur en pile qui empile et dépile des pages avec des transitions.
Exemple
Impossible de charger l'aperçu des propriétés. Sélectionnez Aperçu des propriétés pour réessayer.

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);import fluentqt
stack_view = fluentqt.StackView()
stack_view.setInitialOwnedItem(first_page)
stack_view.pushOwnedItem(next_page)
stack_view.pop()
stack_view.depthChanged.connect(update_status)API
DéclarationAucun membre d'API correspondant.
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 StackViewItemStatusInactiveActivatingActiveDeactivating
enum class StackViewTransitionOperationPushPopReplaceClearNone
enum class StackViewTransitionTypeSlideFadeScaleFadeImmediate
Méthodes
int depth() constNombre de pages actuellement dans la pile.
QWidget* currentItem() constPage de pile actuellement visible.
QWidget* initialItem() constPage initiale insérée dans la pile.
bool busy() constIndique si une opération de transition ou de navigation est en cours.
Qt::Orientation orientation() constOrientation principale de la disposition ou du mouvement.
void setOrientation(Qt::Orientation orientation)Orientation principale de la disposition ou du mouvement.
bool transitionAnimationEnabled() constIndique 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() constDurée de transition de la pile en millisecondes.
void setTransitionDuration(int durationMs)Durée de transition de la pile en millisecondes.
StackViewTransitionType transitionType() constEffet de transition utilisé pour la navigation en pile.
void setTransitionType(StackViewTransitionType type)Effet de transition utilisé pour la navigation en pile.
WidgetOwnership defaultItemOwnership() constMode 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 setInitialItem(QWidget* item, WidgetOwnership ownership)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 depthNombre de pages actuellement dans la pile.
Lecturedepth()NotificationdepthChanged()QWidget* currentItemPage de pile actuellement visible.
LecturecurrentItem()NotificationcurrentItemChanged()QWidget* initialItemPage initiale insérée dans la pile.
LectureinitialItem()ÉcrituresetInitialItem()NotificationinitialItemChanged()bool busyIndique si une opération de transition ou de navigation est en cours.
Lecturebusy()NotificationbusyChanged()Qt::Orientation orientationOrientation principale de la disposition ou du mouvement.
Lectureorientation()ÉcrituresetOrientation()NotificationorientationChanged()bool transitionAnimationEnabledIndique si l'animation de transition de pile est activée.
LecturetransitionAnimationEnabled()ÉcrituresetTransitionAnimationEnabled()NotificationtransitionAnimationEnabledChanged()int transitionDurationDurée de transition de la pile en millisecondes.
LecturetransitionDuration()ÉcrituresetTransitionDuration()NotificationtransitionDurationChanged()StackViewTransitionType transitionTypeEffet de transition utilisé pour la navigation en pile.
LecturetransitionType()ÉcrituresetTransitionType()NotificationtransitionTypeChanged()fluent::WidgetOwnership defaultItemOwnershipMode de libération par défaut pour les pages ajoutées via les API de StackView.
LecturedefaultItemOwnership()ÉcrituresetDefaultItemOwnership()NotificationdefaultItemOwnershipChanged()
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 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 : QStackedWidget