Fluent-Qt

Listen & Tabellen

DrawerView Drawer-Ansicht

Ein Panel, das von einem Fensterrand über den Inhalt gleitet.

Beispiel

DrawerView Drawer-Ansicht: Drawer am rechten Rand

Verwendung

Drawer am rechten Rand

Mit setEdge() eine Kante wählen, mit setDrawerLength() Breite/Höhe festlegen und open() aufrufen (Klicks außerhalb oder Escape schließen ihn standardmäßig).

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

auto* drawer = new DrawerView(host);
drawer->setEdge(DrawerView::DrawerEdge::Right);
drawer->setDrawerLength(260);
drawer->setContentWidget(settingsPanel, WidgetOwnership::Owned);
auto* openButton = new Button("Open drawer", host);
QObject::connect(openButton, &Button::clicked,
                 drawer, &DrawerView::open);

fluent::collections::DrawerView

Erbt von QWidget · FluentElement · QMLPlus

Fensterinternes Rand-Drawer-Overlay mit modaler Blockierung, Abdunklung und Ziehen vom Rand. Nimmt ein Inhalts-Widget auf und übernimmt Randplatzierung, Light-Dismiss, abgerundete Ecken und Gleitanimationen.

Konstruktoren

Destruktoren

Enumerationen

enum class DrawerEdge
  • Left
  • Right
  • Top
  • Bottom
enum CloseFlag
  • NoAutoClose = 0
  • CloseOnPressOutside = 1 << 0
  • CloseOnEscape = 1 << 1

Methoden

bool isOpen() const

Ob der Drawer geöffnet ist.

void setIsOpen(bool open)

Ob der Drawer geöffnet ist.

DrawerEdge edge() const

Fensterkante, von der der Drawer hereingleitet.

void setEdge(DrawerEdge edge)

Fensterkante, von der der Drawer hereingleitet.

qreal position() const

Normalisierter Schiebefortschritt entlang der Öffnungsachse (0.0 geschlossen, 1.0 geöffnet).

void setPosition(qreal position)

Normalisierter Schiebefortschritt entlang der Öffnungsachse (0.0 geschlossen, 1.0 geöffnet).

int drawerLength() const

Entlang der Öffnungsachse gemessene Länge des Drawers.

void setDrawerLength(int length)

Entlang der Öffnungsachse gemessene Länge des Drawers.

QMargins availableMargins() const

Ränder, die vor der Drawer-Platzierung vom besitzenden Fenster abgezogen werden.

void setAvailableMargins(const QMargins& margins)

Ränder, die vor der Drawer-Platzierung vom besitzenden Fenster abgezogen werden.

bool isModal() const

Ob das Overlay Interaktionen außerhalb blockiert.

void setModal(bool modal)

Ob das Overlay Interaktionen außerhalb blockiert.

bool isDim() const

Ob eine abgedunkelte Ebene hinter dem Overlay angezeigt wird.

void setDim(bool dim)

Ob eine abgedunkelte Ebene hinter dem Overlay angezeigt wird.

double dimOpacity() const

Scrim-Deckkraft in [0, 1]; -1 verwendet das Smoke-Token des Themes, wenn dim aktiviert ist.

void setDimOpacity(double opacity)

Scrim-Deckkraft in [0, 1]; -1 verwendet das Smoke-Token des Themes, wenn dim aktiviert ist.

double backdropBlurRadius() const

Unschärferadius des Hintergrunds in [0, 32] px (0 deaktiviert Unschärfe; standardmäßig 4 im modalen Zustand, sonst 0).

void setBackdropBlurRadius(double radius)

Unschärferadius des Hintergrunds in [0, 32] px (0 deaktiviert Unschärfe; standardmäßig 4 im modalen Zustand, sonst 0).

void refreshBackdrop()

Erfasst den Fensterhintergrund nach Änderungen am Hintergrundinhalt erneut.

ClosePolicy closePolicy() const

Richtlinie zur Steuerung des Schließverhaltens bei Klicks außerhalb, Esc oder programmatischem Schließen.

void setClosePolicy(ClosePolicy policy)

Richtlinie zur Steuerung des Schließverhaltens bei Klicks außerhalb, Esc oder programmatischem Schließen.

bool isInteractive() const

Ob der Drawer durch Ziehen mit dem Zeiger bedient werden kann.

void setInteractive(bool interactive)

Ob der Drawer durch Ziehen mit dem Zeiger bedient werden kann.

int dragMargin() const

Randabstand zum Starten des Drawer-Ziehens.

void setDragMargin(int margin)

Randabstand zum Starten des Drawer-Ziehens.

int outerCornerRadius() const

Eckenradius an der Außenkante des Drawers.

void setOuterCornerRadius(int radius)

Eckenradius an der Außenkante des Drawers.

bool isAnimationEnabled() const

Ob Übergänge beim Öffnen und Schließen des Drawers animiert werden.

void setAnimationEnabled(bool enabled)

Ob Übergänge beim Öffnen und Schließen des Drawers animiert werden.

QWidget* contentWidget() const

Im Drawer-Panel gehostetes Widget.

void setContentWidget(QWidget* widget)

Setzt das Drawer-Inhalts-Widget (standardmäßig vom Aufrufer verwaltet, WidgetOwnership::Borrowed).

bool setContentWidget(QWidget* widget, WidgetOwnership ownership)

Setzt das Drawer-Inhalts-Widget mit einem expliziten Bereinigungsmodus über WidgetOwnership.

QWidget* takeContentWidget()

Löst das aktuelle Inhalts-Widget und gibt es zurück, ohne es zu löschen.

WidgetOwnership contentOwnership() const

Freigaberichtlinie für das aktuelle Inhalts-Widget.

Eigenschaften

bool isOpen

Ob der Drawer geöffnet ist.

Lesen isOpen()Schreiben setIsOpen()Benachrichtigung isOpenChanged()
DrawerEdge edge

Fensterkante, von der der Drawer hereingleitet.

Lesen edge()Schreiben setEdge()Benachrichtigung edgeChanged()
qreal position

Normalisierter Schiebefortschritt entlang der Öffnungsachse (0.0 geschlossen, 1.0 geöffnet).

Lesen position()Schreiben setPosition()Benachrichtigung positionChanged()
int drawerLength

Entlang der Öffnungsachse gemessene Länge des Drawers.

Lesen drawerLength()Schreiben setDrawerLength()Benachrichtigung drawerLengthChanged()
QMargins availableMargins

Ränder, die vor der Drawer-Platzierung vom besitzenden Fenster abgezogen werden.

Lesen availableMargins()Schreiben setAvailableMargins()Benachrichtigung availableMarginsChanged()
bool modal

Ob das Overlay Interaktionen außerhalb blockiert.

Lesen isModal()Schreiben setModal()Benachrichtigung modalChanged()
bool dim

Ob eine abgedunkelte Ebene hinter dem Overlay angezeigt wird.

Lesen isDim()Schreiben setDim()Benachrichtigung dimChanged()
double dimOpacity

Scrim-Deckkraft in [0, 1]; -1 verwendet das Smoke-Token des Themes, wenn dim aktiviert ist.

Lesen dimOpacity()Schreiben setDimOpacity()Benachrichtigung dimOpacityChanged()
double backdropBlurRadius

Unschärferadius des Hintergrunds in [0, 32] px (0 deaktiviert Unschärfe; standardmäßig 4 im modalen Zustand, sonst 0).

Lesen backdropBlurRadius()Schreiben setBackdropBlurRadius()Benachrichtigung backdropBlurRadiusChanged()
ClosePolicy closePolicy

Richtlinie zur Steuerung des Schließverhaltens bei Klicks außerhalb, Esc oder programmatischem Schließen.

Lesen closePolicy()Schreiben setClosePolicy()Benachrichtigung closePolicyChanged()
bool interactive

Ob der Drawer durch Ziehen mit dem Zeiger bedient werden kann.

Lesen isInteractive()Schreiben setInteractive()Benachrichtigung interactiveChanged()
int dragMargin

Randabstand zum Starten des Drawer-Ziehens.

Lesen dragMargin()Schreiben setDragMargin()Benachrichtigung dragMarginChanged()
int outerCornerRadius

Eckenradius an der Außenkante des Drawers.

Lesen outerCornerRadius()Schreiben setOuterCornerRadius()Benachrichtigung outerCornerRadiusChanged()
bool animationEnabled

Ob Übergänge beim Öffnen und Schließen des Drawers animiert werden.

Lesen isAnimationEnabled()Schreiben setAnimationEnabled()Benachrichtigung animationEnabledChanged()
QWidget* contentWidget

Im Drawer-Panel gehostetes Widget.

Lesen contentWidget()Schreiben setContentWidget()Benachrichtigung contentWidgetChanged()
fluent::WidgetOwnership contentOwnership

Freigaberichtlinie für das aktuelle Inhalts-Widget.

Lesen contentOwnership()Benachrichtigung contentOwnershipChanged()

Signale

void isOpenChanged(bool open)

Ob der Drawer geöffnet ist.

void edgeChanged(DrawerEdge edge)

Fensterkante, von der der Drawer hereingleitet.

void positionChanged(qreal position)

Normalisierter Schiebefortschritt entlang der Öffnungsachse (0.0 geschlossen, 1.0 geöffnet).

void drawerLengthChanged(int length)

Entlang der Öffnungsachse gemessene Länge des Drawers.

void availableMarginsChanged(const QMargins& margins)

Ränder, die vor der Drawer-Platzierung vom besitzenden Fenster abgezogen werden.

void modalChanged(bool modal)

Ob das Overlay Interaktionen außerhalb blockiert.

void dimChanged(bool dim)

Ob eine abgedunkelte Ebene hinter dem Overlay angezeigt wird.

void dimOpacityChanged(double opacity)

Scrim-Deckkraft in [0, 1]; -1 verwendet das Smoke-Token des Themes, wenn dim aktiviert ist.

void backdropBlurRadiusChanged(double radius)

Unschärferadius des Hintergrunds in [0, 32] px (0 deaktiviert Unschärfe; standardmäßig 4 im modalen Zustand, sonst 0).

void closePolicyChanged(ClosePolicy policy)

Richtlinie zur Steuerung des Schließverhaltens bei Klicks außerhalb, Esc oder programmatischem Schließen.

void interactiveChanged(bool interactive)

Ob der Drawer durch Ziehen mit dem Zeiger bedient werden kann.

void dragMarginChanged(int margin)

Randabstand zum Starten des Drawer-Ziehens.

void outerCornerRadiusChanged(int radius)

Eckenradius an der Außenkante des Drawers.

void animationEnabledChanged(bool enabled)

Ob Übergänge beim Öffnen und Schließen des Drawers animiert werden.

void contentWidgetChanged(QWidget* widget)

Im Drawer-Panel gehostetes Widget.

void contentOwnershipChanged(WidgetOwnership ownership)

Freigaberichtlinie für das aktuelle Inhalts-Widget.

Typen und Aliase

PySide6-Erweiterungen

setOwnedContentWidget(widget)

Setzt den Inhalt der Schublade. Beim Entfernen wird er gelöscht.

setBorrowedContentWidget(widget)

Setzt geliehenen Inhalt. Bei der Freigabe hat er kein Elternwidget mehr.

setReparentedContentWidget(widget)

Setzt Inhalt, der bei der Freigabe 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