Fluent-Qt

Navigation

NavigationView Vue de navigation

Un volet gauche adaptatif accompagné d'une zone de contenu pour la navigation principale.

Exemple

NavigationView Vue de navigation: Emplacements de structure

Utilisation

Emplacements de structure

Les zones d'en-tête, principale et de pied de page sont des widgets appartenant à l'appelant ; NavigationView se charge uniquement de leur géométrie dans le cadre.

#include <FluentQt/Navigation.h>
using namespace fluent::navigation;

auto* navView = new NavigationView(this);
navView->setMinimumWidth(440);
navView->setMaximumWidth(620);
navView->setFixedHeight(340);
navView->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
navView->setDisplayMode(NavigationView::DisplayMode::Left);
navView->setExpandedPaneWidth(180);
navView->setHeaderChromeWidget(headerSection);
navView->setMainChromeWidget(mainSection);
navView->setFooterChromeWidget(footerSection);
populateNavigationPages(navView->contentHost());
auto routeToPage = [host = navView->contentHost()](int pageIndex) {
    const int direction = pageIndex >= host->currentIndex() ? 1 : -1;
    host->setCurrentIndex(pageIndex, direction, true);
};
headerSection->onActivated = routeToPage;
mainSection->onActivated = routeToPage;
footerSection->onActivated = routeToPage;

fluent::navigation::NavigationView

Hérite de QWidget · FluentElement · QMLPlus

Conteneur de navigation adaptatif avec modes d'affichage de volet et hôte de contenu. Gère la géométrie des volets, les transitions haut/côté, les largeurs compactes et les points de rupture réactifs, tandis que l'appelant fournit les widgets de volet et les pages.

Constructeurs

Destructeurs

Énumérations

enum class DisplayMode
  • Auto
  • Left
  • LeftCompact
  • LeftMinimal
  • Top

Méthodes

DisplayMode displayMode() const

Mode de mise en page de navigation demandé avant l'application des contraintes réactives.

void setDisplayMode(DisplayMode mode)

Mode de mise en page de navigation demandé avant l'application des contraintes réactives.

DisplayMode effectiveDisplayMode() const

Mode d'affichage après l'application des contraintes responsives.

bool isPaneOpen() const

Indique si le volet de navigation est ouvert.

void setPaneOpen(bool open)

Indique si le volet de navigation est ouvert.

int compactModeThresholdWidth() const

Seuil de largeur pour le mode de navigation compact.

void setCompactModeThresholdWidth(int width)

Seuil de largeur pour le mode de navigation compact.

int expandedModeThresholdWidth() const

Seuil de largeur pour le mode de navigation étendu.

void setExpandedModeThresholdWidth(int width)

Seuil de largeur pour le mode de navigation étendu.

int expandedPaneWidth() const

Largeur du volet de navigation en mode étendu.

void setExpandedPaneWidth(int width)

Largeur du volet de navigation en mode étendu.

int compactPaneWidth() const

Largeur du volet de navigation en mode compact.

void setCompactPaneWidth(int width)

Largeur du volet de navigation en mode compact.

int topBarHeight() const

Hauteur de la barre de navigation supérieure en pixels.

void setTopBarHeight(int height)

Hauteur de la barre de navigation supérieure en pixels.

bool isAnimationEnabled() const

Indique si les transitions de volet et de mode de disposition sont animées.

void setAnimationEnabled(bool enabled)

Indique si les transitions de volet et de mode de disposition sont animées.

bool setHeaderChromeWidget(QWidget* widget, WidgetOwnership ownership)

Définit le widget d'habillage d'en-tête avec une politique de propriété explicite.

QWidget* takeHeaderChromeWidget()

Détache et renvoie le widget d'habillage d'en-tête sans appliquer son nettoyage de propriété.

bool releaseHeaderChromeWidget()

Retire le widget d'habillage de l'en-tête et applique sa politique de propriété configurée.

bool setMainChromeWidget(QWidget* widget, WidgetOwnership ownership)

Définit le widget d'habillage principal avec une politique de propriété explicite.

QWidget* takeMainChromeWidget()

Détache et renvoie le widget d'habillage principal sans appliquer son nettoyage de propriété.

bool releaseMainChromeWidget()

Retire le widget d'habillage principal et applique sa politique de propriété configurée.

Propriétés

DisplayMode displayMode

Mode de mise en page de navigation demandé avant l'application des contraintes réactives.

Lecture displayMode()Écriture setDisplayMode()Notification displayModeChanged()
DisplayMode effectiveDisplayMode

Mode d'affichage après l'application des contraintes responsives.

Lecture effectiveDisplayMode()Notification effectiveDisplayModeChanged()
bool paneOpen

Indique si le volet de navigation est ouvert.

Lecture isPaneOpen()Écriture setPaneOpen()Notification paneOpenChanged()
int compactModeThresholdWidth

Seuil de largeur pour le mode de navigation compact.

Lecture compactModeThresholdWidth()Écriture setCompactModeThresholdWidth()Notification compactModeThresholdWidthChanged()
int expandedModeThresholdWidth

Seuil de largeur pour le mode de navigation étendu.

Lecture expandedModeThresholdWidth()Écriture setExpandedModeThresholdWidth()Notification expandedModeThresholdWidthChanged()
int expandedPaneWidth

Largeur du volet de navigation en mode étendu.

Lecture expandedPaneWidth()Écriture setExpandedPaneWidth()Notification expandedPaneWidthChanged()
int compactPaneWidth

Largeur du volet de navigation en mode compact.

Lecture compactPaneWidth()Écriture setCompactPaneWidth()Notification compactPaneWidthChanged()
int topBarHeight

Hauteur de la barre de navigation supérieure en pixels.

Lecture topBarHeight()Écriture setTopBarHeight()Notification topBarHeightChanged()
bool animationEnabled

Indique si les transitions de volet et de mode de disposition sont animées.

Lecture isAnimationEnabled()Écriture setAnimationEnabled()Notification animationEnabledChanged()
qreal layoutTransitionProgress

Progression utilisée par les transitions de disposition de navigation.

Lecture layoutTransitionProgress()Écriture setLayoutTransitionProgress()

Signaux

void displayModeChanged(DisplayMode mode)

Mode de mise en page de navigation demandé avant l'application des contraintes réactives.

void effectiveDisplayModeChanged(DisplayMode mode)

Mode d'affichage après l'application des contraintes responsives.

void paneOpenChanged(bool open)

Indique si le volet de navigation est ouvert.

void compactModeThresholdWidthChanged(int width)

Seuil de largeur pour le mode de navigation compact.

void expandedModeThresholdWidthChanged(int width)

Seuil de largeur pour le mode de navigation étendu.

void expandedPaneWidthChanged(int width)

Largeur du volet de navigation en mode étendu.

void compactPaneWidthChanged(int width)

Largeur du volet de navigation en mode compact.

void topBarHeightChanged(int height)

Hauteur de la barre de navigation supérieure en pixels.

void animationEnabledChanged(bool enabled)

Indique si les transitions de volet et de mode de disposition sont animées.

Ajouts PySide6

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