Fluent-Qt

Navigation

TabView Registerkartenansicht

Eine Registerkartenleiste mit Auswahl, Schließen und Neuanordnung per Ziehen; die Seiten werden von Ihrer App bereitgestellt.

Beispiel

TabView Registerkartenansicht: TabView mit gehosteten Seiten

Verwendung

TabView mit gehosteten Seiten

currentChanged verbinden, um einen StackContentHost zu synchronisieren, und tabMoved behandeln, wenn setTabReorderEnabled(true) aktiviert ist.

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

auto* surface = new QWidget(this);
surface->setMinimumWidth(360);
surface->setMaximumWidth(560);
surface->setFixedHeight(186);
surface->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
auto* layout = new QVBoxLayout(surface);
layout->setContentsMargins(0, 0, 0, 0);
layout->setSpacing(0);

auto* tabs = new TabView(surface);
tabs->setFixedHeight(40);
tabs->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
tabs->setTabWidthMode(TabView::TabWidthMode::SizeToContent);
tabs->setTabReorderEnabled(true);
tabs->setTabsClosable(false);
tabs->setAddTabButtonVisible(false);
tabs->addTab(TabViewItem("Home", Typography::Icons::Home));
tabs->addTab(TabViewItem("Details", Typography::Icons::Document));
tabs->addTab(TabViewItem("Activity", Typography::Icons::Calendar));

auto* host = new StackContentHost(surface);
host->setFixedHeight(146);
host->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
for (int i = 0; i < tabs->tabCount(); ++i)
    host->insertPage(i, createPage(tabs->tabAt(i).text));

connect(tabs, &TabView::currentChanged,
        host, [host](int index) { host->setCurrentIndex(index, 0, true); });
connect(tabs, &TabView::tabMoved,
        host, [host](int from, int to) { host->movePage(from, to); });
layout->addWidget(tabs);
layout->addWidget(host);

fluent::navigation::TabView

Erbt von QWidget · FluentElement · fluent::QMLPlus

Fluent-Registerkartenleiste mit Unterstützung für Schließen, Neuanordnung per Ziehen, Überlauf und Tastenkombinationen. Verwaltet Registerkarten und Auswahl über TabStrip, während Aufrufer die zugehörigen Inhaltsseiten zusammenstellen.

Konstruktoren

Destruktoren

Enumerationen

enum class TabWidthMode
  • Equal
  • SizeToContent
  • Compact

Methoden

int tabCount() const

Anzahl der derzeit von TabView verwalteten Tabs.

int selectedIndex() const

Aktuell ausgewählter Tab-Index.

void setSelectedIndex(int index)

Aktuell ausgewählter Tab-Index.

TabWidthMode tabWidthMode() const

Von Tabs verwendeter Breitenanpassungsmodus.

void setTabWidthMode(TabWidthMode mode)

Von Tabs verwendeter Breitenanpassungsmodus.

CloseButtonOverlayMode closeButtonOverlayMode() const

Sichtbarkeitsverhalten für Tab-Schließschaltflächen.

void setCloseButtonOverlayMode(CloseButtonOverlayMode mode)

Sichtbarkeitsverhalten für Tab-Schließschaltflächen.

bool tabsClosable() const

Ob Tabs standardmäßig Schließen-Schaltflächen anzeigen.

void setTabsClosable(bool closable)

Ob Tabs standardmäßig Schließen-Schaltflächen anzeigen.

bool addTabButtonVisible() const

Ob die Schaltfläche zum Hinzufügen eines Tabs sichtbar ist.

void setAddTabButtonVisible(bool visible)

Ob die Schaltfläche zum Hinzufügen eines Tabs sichtbar ist.

bool tabReorderEnabled() const

Ob Benutzer Tabs neu anordnen können.

void setTabReorderEnabled(bool enabled)

Ob Benutzer Tabs neu anordnen können.

bool keyboardAcceleratorsEnabled() const

Ob Tastaturkürzel für Tabs aktiviert sind.

void setKeyboardAcceleratorsEnabled(bool enabled)

Ob Tastaturkürzel für Tabs aktiviert sind.

Typography::FontRole tabFontRole() const

Schriftrolle für Registerkartentext.

void setTabFontRole(Typography::FontRole role)

Schriftrolle für Registerkartentext.

QString iconFontFamily() const

Symbolschriftart-Familie für Tab-Glyphen.

void setIconFontFamily(const QString& family)

Symbolschriftart-Familie für Tab-Glyphen.

Eigenschaften

int tabCount

Anzahl der derzeit von TabView verwalteten Tabs.

Lesen tabCount()Benachrichtigung tabsChanged()
int selectedIndex

Aktuell ausgewählter Tab-Index.

Lesen selectedIndex()Schreiben setSelectedIndex()Benachrichtigung selectedIndexChanged()
TabWidthMode tabWidthMode

Von Tabs verwendeter Breitenanpassungsmodus.

Lesen tabWidthMode()Schreiben setTabWidthMode()Benachrichtigung tabWidthModeChanged()
CloseButtonOverlayMode closeButtonOverlayMode

Sichtbarkeitsverhalten für Tab-Schließschaltflächen.

Lesen closeButtonOverlayMode()Schreiben setCloseButtonOverlayMode()Benachrichtigung closeButtonOverlayModeChanged()
bool tabsClosable

Ob Tabs standardmäßig Schließen-Schaltflächen anzeigen.

Lesen tabsClosable()Schreiben setTabsClosable()Benachrichtigung tabsClosableChanged()
bool addTabButtonVisible

Ob die Schaltfläche zum Hinzufügen eines Tabs sichtbar ist.

Lesen addTabButtonVisible()Schreiben setAddTabButtonVisible()Benachrichtigung addTabButtonVisibleChanged()
bool tabReorderEnabled

Ob Benutzer Tabs neu anordnen können.

Lesen tabReorderEnabled()Schreiben setTabReorderEnabled()Benachrichtigung tabReorderEnabledChanged()
bool keyboardAcceleratorsEnabled

Ob Tastaturkürzel für Tabs aktiviert sind.

Lesen keyboardAcceleratorsEnabled()Schreiben setKeyboardAcceleratorsEnabled()Benachrichtigung keyboardAcceleratorsEnabledChanged()
Typography::FontRole tabFontRole

Schriftrolle für Registerkartentext.

Lesen tabFontRole()Schreiben setTabFontRole()Benachrichtigung tabFontRoleChanged()
QString iconFontFamily

Symbolschriftart-Familie für Tab-Glyphen.

Lesen iconFontFamily()Schreiben setIconFontFamily()Benachrichtigung iconFontFamilyChanged()

Signale

void tabsChanged()

Anzahl der derzeit von TabView verwalteten Tabs.

void selectedIndexChanged(int index)

Aktuell ausgewählter Tab-Index.

void tabWidthModeChanged(TabWidthMode mode)

Von Tabs verwendeter Breitenanpassungsmodus.

void closeButtonOverlayModeChanged(CloseButtonOverlayMode mode)

Sichtbarkeitsverhalten für Tab-Schließschaltflächen.

void tabsClosableChanged(bool closable)

Ob Tabs standardmäßig Schließen-Schaltflächen anzeigen.

void addTabButtonVisibleChanged(bool visible)

Ob die Schaltfläche zum Hinzufügen eines Tabs sichtbar ist.

void tabReorderEnabledChanged(bool enabled)

Ob Benutzer Tabs neu anordnen können.

void keyboardAcceleratorsEnabledChanged(bool enabled)

Ob Tastaturkürzel für Tabs aktiviert sind.

void tabFontRoleChanged(Typography::FontRole role)

Schriftrolle für Registerkartentext.

void iconFontFamilyChanged(const QString& family)

Symbolschriftart-Familie für Tab-Glyphen.

Geschützte Elemente

Methoden

Geerbt von fluent::FluentElement

Enumerationen

enum Theme

Globales visuelles Theme zum Auflösen von Design-Tokens.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Methoden

static void setTheme(Theme theme)

Aktualisiert das globale Theme und benachrichtigt aktive FluentElement-Instanzen.

static void setThemeDeferred(Theme theme)

Plant eine gebündelte Theme-Aktualisierung mit Priorität für sichtbare Elemente, ohne die aktuelle Interaktion zu blockieren.

static Theme currentTheme()

Gibt das aktuell aktive globale Design zurück.

static bool themeUsesDarkAppearance(Theme theme)

Gibt zurück, ob ein Theme Chrome und Material-Tokens auf dunklem Hintergrund verwendet.

static void refreshTheme()

Sendet das aktuelle Theme nach einer Änderung von Design-Tokens erneut, um ein Neuzeichnen auszulösen.

static int themeGeneration()

Monotoner Zähler zur Veraltungsprüfung, der bei jedem Designwechsel erhöht wird.

Theme effectiveTheme() const

Löst das von diesem Element verwendete Theme auf und berücksichtigt dabei eine geerbte QWidget-Überschreibung.

bool effectiveThemeUsesDarkAppearance() const

Gibt zurück, ob das effektive Theme dieses Elements Chrome auf dunklem Hintergrund verwendet.

bool setThemeOverrides(const QJsonObject& overrides)

Ersetzt die selektiven Farb-, Radius- und Schrift-Token-Überschreibungen dieses Elements.

QJsonObject themeOverrides() const

Gibt die festgelegten Überschreibungen dieses Elements zurück.

void clearThemeOverrides()

Setzt alle Token-Felder auf die Standardwerte des globalen Designs zurück.

const Colors& themeColorsRef() const

Kopiefreier Zugriff auf das aktive Farbset für kritische Zeichenpfade.

Material::AcrylicToken themeAcrylic() const

Material-, Höhenstufen- und adaptive Layout-Tokens.

QColor themeBackdrop(bool active) const

Backdrop-Farbe des Fenster-Chrome für den angegebenen Aktivierungszustand.

virtual void onThemeUpdated()

Wird nach einer Änderung des globalen Themes aufgerufen.

Typen und Aliase

struct Colors

An Komponenten zurückgegebene Design-Token-Snapshots.

Geerbt von fluent::QMLPlus

Methoden

AnchorLayout::Anchors* anchors()

Gibt veränderbare Anker für den QWidget-Host zurück.

void setState(const QString& name)

Wendet einen registrierten Zustand anhand seines Namens an oder stellt den Standardzustand wieder her, wenn @p name leer ist. Unbekannte Namen werden ignoriert, und bestehende Bindungen werden beim Verlassen des Zustands wieder aufgenommen.

void addState(const QMLState& state)

Registriert oder ersetzt eine benannte Zustandsdefinition; das Ersetzen des aktiven Zustands wendet diesen sofort an.

void evaluateStates()

Wertet Zustandsbedingungen in Registrierungsreihenfolge neu aus und aktiviert den ersten Treffer oder den Standardzustand, wenn keiner zutrifft. Wird auch automatisch bei Benachrichtigungen abhängiger Eigenschaften ausgeführt; abgeleitete Zustände mit extend erben Änderungen der Vorgänger, sofern keine Zyklen vorliegen oder Vorgänger fehlen.

QMLPlusRuntime* runtime()

Gibt den bei Bedarf erstellten Zustandsbeobachter im Besitz dieses Hosts zurück.

void setAnchors(const AnchorLayout::Anchors& anchors)

Ersetzt alle Host-Anker und macht das übergeordnete Layout ungültig.

void resetAnchors()

Löscht alle Host-Anker und invalidiert das übergeordnete Layout.

void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)

Bindet @p sourceProp von @p source über PropertyBinder::bind() an @p targetProp dieses QWidget-Hosts.

void addTransition(const StateTransition& transition)

Registriert einen Zustandsübergang in Prioritätsreihenfolge.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Setzt die Standardanimation, die beim Schreiben von @p propertyName über writeProperty() oder eine Bindung verwendet wird. Explizite StateTransition-Regeln haben Vorrang; direkte C++-Setter-Aufrufe werden nicht animiert.

void clearBehavior(const char* propertyName)

Entfernt die Standardanimation für zukünftige verwaltete Schreibvorgänge.

bool writeProperty(const char* propertyName, const QVariant& value)

Schreibt eine Host-Eigenschaft über Behavior, ohne deren Bindung zu entfernen.

Qt-Basisklassendokumentation: QWidget

fluent::navigation::TabViewItem

Konstruktoren

Felder

fluent::navigation::TabStrip

Erbt von QWidget · FluentElement

Internes Tab-Leisten-Widget, das Tabs, Schaltflächen und Auswahlindikatoren anordnet und zeichnet. Übernimmt Treffertests, Neuanordnung per Ziehen und Indikatoranimationen getrennt von der Seitenkoordination der TabView.

Konstruktoren

Enumerationen

enum class WidthMode
  • Equal
  • SizeToContent
  • Compact

Methoden

Eigenschaften

QRect animatedIndicatorRect

Aktuelles animiertes Indikatorrechteck in TabStrip-Koordinaten.

Lesen animatedIndicatorRect()Schreiben setAnimatedIndicatorRect()

Signale

Geschützte Elemente

Methoden