Fluent-Qt

Listen & Tabellen

SplitView Geteilte Ansicht

Nimmt in der Größe veränderbare Bereiche auf, die durch ziehbare Trennleisten getrennt sind.

Beispiel

SplitView Geteilte Ansicht: Größenveränderbare Bereiche

Verwendung

Größenveränderbare Bereiche

Die Trennleiste zwischen den Bereichen ziehen, um deren Größe anzupassen.

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

auto* splitView = new SplitView(this);
splitView->addPane(firstPane);
splitView->addPane(secondPane);
splitView->addPane(thirdPane);
splitView->setPanePreferredSize(0, 150);
splitView->setPaneFill(2, true);

fluent::collections::SplitView

Erbt von QWidget · FluentElement · QMLPlus

Größenveränderbarer Mehrfachbereichs-Container mit ziehbaren Fluent-Trennleistengriffen. Verwaltet Bereichsreihenfolge, Größenbegrenzungen, Füllbereichsdehnung, Ausrichtung und Zustandsserialisierung.

Konstruktoren

Destruktoren

Methoden

int addPane(QWidget* pane, WidgetOwnership ownership, const SplitViewPaneOptions& options = SplitViewPaneOptions())

Hängt ein Bereichs-Widget mit einem expliziten WidgetOwnership-Freigabemodus an.

int insertPane(int index, QWidget* pane, WidgetOwnership ownership, const SplitViewPaneOptions& options = SplitViewPaneOptions())

Fügt ein Bereichs-Widget an index mit einem expliziten WidgetOwnership-Freigabemodus ein.

bool removePane(QWidget* pane)

Legacy-Entfernung, die den Bereich ablöst, ohne ihn zu löschen.

QWidget* removePaneAt(int index)

Legacy-Entfernung, die den Bereich bei index ablöst und zurückgibt, ohne ihn zu löschen.

bool releasePane(QWidget* pane)

Entfernt einen Bereich und gibt ihn gemäß seinem WidgetOwnership-Modus frei.

bool releasePaneAt(int index)

Entfernt den Bereich an Position index und gibt ihn gemäß seinem WidgetOwnership-Modus frei.

QWidget* takePaneAt(int index)

Entfernt den Bereich an Position index und gibt ihn zurück, ohne ihn zu löschen.

WidgetOwnership paneOwnershipAt(int index) const

Gibt den für den Bereich an index konfigurierten Freigabemodus zurück.

Qt::Orientation orientation() const

Primäre Layout- oder Bewegungsausrichtung.

void setOrientation(Qt::Orientation orientation)

Primäre Layout- oder Bewegungsausrichtung.

bool resizing() const

Ob ein Teilungsgriff aktuell gezogen wird.

int handleWidth() const

Interaktive Breite des Teilungsgriffs.

void setHandleWidth(int width)

Interaktive Breite des Teilungsgriffs.

int handleVisualThickness() const

Gezeichnete Stärke des Teilungsgriff-Indikators.

void setHandleVisualThickness(int thickness)

Gezeichnete Stärke des Teilungsgriff-Indikators.

int fillPaneIndex() const

Bereichsindex, der den verbleibenden Platz von SplitView einnimmt.

void setFillPaneIndex(int index)

Bereichsindex, der den verbleibenden Platz von SplitView einnimmt.

QSize defaultSizeHint() const

Ersatz-Größenhinweis, wenn ein Panel keinen bereitstellt.

void setDefaultSizeHint(const QSize& size)

Ersatz-Größenhinweis, wenn ein Panel keinen bereitstellt.

QSize defaultMinimumSizeHint() const

Ersatz-Mindestgrößenhinweis für ein Panel.

void setDefaultMinimumSizeHint(const QSize& size)

Ersatz-Mindestgrößenhinweis für ein Panel.

Eigenschaften

Qt::Orientation orientation

Primäre Layout- oder Bewegungsausrichtung.

Lesen orientation()Schreiben setOrientation()Benachrichtigung orientationChanged()
bool resizing

Ob ein Teilungsgriff aktuell gezogen wird.

Lesen resizing()Benachrichtigung resizingChanged()
int handleWidth

Interaktive Breite des Teilungsgriffs.

Lesen handleWidth()Schreiben setHandleWidth()Benachrichtigung handleWidthChanged()
int handleVisualThickness

Gezeichnete Stärke des Teilungsgriff-Indikators.

Lesen handleVisualThickness()Schreiben setHandleVisualThickness()Benachrichtigung handleVisualThicknessChanged()
int fillPaneIndex

Bereichsindex, der den verbleibenden Platz von SplitView einnimmt.

Lesen fillPaneIndex()Schreiben setFillPaneIndex()Benachrichtigung fillPaneIndexChanged()
QSize defaultSizeHint

Ersatz-Größenhinweis, wenn ein Panel keinen bereitstellt.

Lesen defaultSizeHint()Schreiben setDefaultSizeHint()Benachrichtigung defaultSizeHintChanged()
QSize defaultMinimumSizeHint

Ersatz-Mindestgrößenhinweis für ein Panel.

Lesen defaultMinimumSizeHint()Schreiben setDefaultMinimumSizeHint()Benachrichtigung defaultMinimumSizeHintChanged()

Signale

void orientationChanged(Qt::Orientation orientation)

Primäre Layout- oder Bewegungsausrichtung.

void resizingChanged(bool resizing)

Ob ein Teilungsgriff aktuell gezogen wird.

void handleWidthChanged(int width)

Interaktive Breite des Teilungsgriffs.

void handleVisualThicknessChanged(int thickness)

Gezeichnete Stärke des Teilungsgriff-Indikators.

void fillPaneIndexChanged(int index)

Bereichsindex, der den verbleibenden Platz von SplitView einnimmt.

void defaultSizeHintChanged(const QSize& size)

Ersatz-Größenhinweis, wenn ein Panel keinen bereitstellt.

void defaultMinimumSizeHintChanged(const QSize& size)

Ersatz-Mindestgrößenhinweis für ein Panel.

PySide6-Erweiterungen

addOwnedPane(pane, options=None)

Hängt einen Bereich an, der beim Entfernen aus der SplitView gelöscht wird.

addBorrowedPane(pane, options=None)

Hängt einen Bereich an, der nach dem Entfernen aus der SplitView kein Elternwidget mehr hat.

addReparentedPane(pane, options=None)

Hängt einen Bereich an, der beim Entfernen zu seinem bisherigen übergeordneten QWidget zurückkehrt.

insertOwnedPane(index, pane, options=None)

Fügt einen Bereich ein, der beim Entfernen aus der SplitView gelöscht wird.

insertBorrowedPane(index, pane, options=None)

Fügt einen Bereich ein, der nach dem Entfernen aus der SplitView kein Elternwidget mehr hat.

insertReparentedPane(index, pane, options=None)

Fügt einen Bereich ein, der beim Entfernen zu seinem bisherigen übergeordneten QWidget zurückkehrt.

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::collections::SplitViewPaneOptions

Felder