Listen & Tabellen
DrawerView Drawer-Ansicht
Ein Panel, das von einem Fensterrand über den Inhalt gleitet.
Beispiel
Die Eigenschaftsvorschau konnte nicht geladen werden. Wählen Sie „Eigenschaftsvorschau“, um es erneut zu versuchen.

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);import fluentqt
drawer = fluentqt.DrawerView(host)
drawer.setEdge(fluentqt.DrawerView.DrawerEdge.Right)
drawer.setDrawerLength(260)
drawer.setOwnedContentWidget(settings_panel)
open_button = fluentqt.Button("Open drawer", host)
open_button.clicked.connect(drawer.open)API
DeklarationKeine passenden API-Elemente.
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 DrawerEdgeLeftRightTopBottom
enum CloseFlagNoAutoClose = 0CloseOnPressOutside = 1 << 0CloseOnEscape = 1 << 1
Methoden
bool isOpen() constOb der Drawer geöffnet ist.
void setIsOpen(bool open)Ob der Drawer geöffnet ist.
DrawerEdge edge() constFensterkante, von der der Drawer hereingleitet.
void setEdge(DrawerEdge edge)Fensterkante, von der der Drawer hereingleitet.
qreal position() constNormalisierter 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() constEntlang der Öffnungsachse gemessene Länge des Drawers.
void setDrawerLength(int length)Entlang der Öffnungsachse gemessene Länge des Drawers.
QMargins availableMargins() constRä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() constOb das Overlay Interaktionen außerhalb blockiert.
void setModal(bool modal)Ob das Overlay Interaktionen außerhalb blockiert.
bool isDim() constOb eine abgedunkelte Ebene hinter dem Overlay angezeigt wird.
void setDim(bool dim)Ob eine abgedunkelte Ebene hinter dem Overlay angezeigt wird.
double dimOpacity() constScrim-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() constUnschä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() constRichtlinie 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() constOb 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() constRandabstand zum Starten des Drawer-Ziehens.
void setDragMargin(int margin)Randabstand zum Starten des Drawer-Ziehens.
int outerCornerRadius() constEckenradius an der Außenkante des Drawers.
void setOuterCornerRadius(int radius)Eckenradius an der Außenkante des Drawers.
bool isAnimationEnabled() constOb Ü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() constIm 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() constFreigaberichtlinie für das aktuelle Inhalts-Widget.
Eigenschaften
bool isOpenOb der Drawer geöffnet ist.
LesenisOpen()SchreibensetIsOpen()BenachrichtigungisOpenChanged()DrawerEdge edgeFensterkante, von der der Drawer hereingleitet.
Lesenedge()SchreibensetEdge()BenachrichtigungedgeChanged()qreal positionNormalisierter Schiebefortschritt entlang der Öffnungsachse (0.0 geschlossen, 1.0 geöffnet).
Lesenposition()SchreibensetPosition()BenachrichtigungpositionChanged()int drawerLengthEntlang der Öffnungsachse gemessene Länge des Drawers.
LesendrawerLength()SchreibensetDrawerLength()BenachrichtigungdrawerLengthChanged()QMargins availableMarginsRänder, die vor der Drawer-Platzierung vom besitzenden Fenster abgezogen werden.
LesenavailableMargins()SchreibensetAvailableMargins()BenachrichtigungavailableMarginsChanged()bool modalOb das Overlay Interaktionen außerhalb blockiert.
LesenisModal()SchreibensetModal()BenachrichtigungmodalChanged()bool dimOb eine abgedunkelte Ebene hinter dem Overlay angezeigt wird.
LesenisDim()SchreibensetDim()BenachrichtigungdimChanged()double dimOpacityScrim-Deckkraft in [0, 1]; -1 verwendet das Smoke-Token des Themes, wenn dim aktiviert ist.
LesendimOpacity()SchreibensetDimOpacity()BenachrichtigungdimOpacityChanged()double backdropBlurRadiusUnschärferadius des Hintergrunds in [0, 32] px (0 deaktiviert Unschärfe; standardmäßig 4 im modalen Zustand, sonst 0).
LesenbackdropBlurRadius()SchreibensetBackdropBlurRadius()BenachrichtigungbackdropBlurRadiusChanged()ClosePolicy closePolicyRichtlinie zur Steuerung des Schließverhaltens bei Klicks außerhalb, Esc oder programmatischem Schließen.
LesenclosePolicy()SchreibensetClosePolicy()BenachrichtigungclosePolicyChanged()bool interactiveOb der Drawer durch Ziehen mit dem Zeiger bedient werden kann.
LesenisInteractive()SchreibensetInteractive()BenachrichtigunginteractiveChanged()int dragMarginRandabstand zum Starten des Drawer-Ziehens.
LesendragMargin()SchreibensetDragMargin()BenachrichtigungdragMarginChanged()int outerCornerRadiusEckenradius an der Außenkante des Drawers.
LesenouterCornerRadius()SchreibensetOuterCornerRadius()BenachrichtigungouterCornerRadiusChanged()bool animationEnabledOb Übergänge beim Öffnen und Schließen des Drawers animiert werden.
LesenisAnimationEnabled()SchreibensetAnimationEnabled()BenachrichtigunganimationEnabledChanged()QWidget* contentWidgetIm Drawer-Panel gehostetes Widget.
LesencontentWidget()SchreibensetContentWidget()BenachrichtigungcontentWidgetChanged()fluent::WidgetOwnership contentOwnershipFreigaberichtlinie für das aktuelle Inhalts-Widget.
LesencontentOwnership()BenachrichtigungcontentOwnershipChanged()
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 ThemeGlobales visuelles Theme zum Auflösen von Design-Tokens.
Light = 0Dark = 1HighContrast = 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() constLöst das von diesem Element verwendete Theme auf und berücksichtigt dabei eine geerbte QWidget-Überschreibung.
bool effectiveThemeUsesDarkAppearance() constGibt 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() constGibt die festgelegten Überschreibungen dieses Elements zurück.
void clearThemeOverrides()Setzt alle Token-Felder auf die Standardwerte des globalen Designs zurück.
const Colors& themeColorsRef() constKopiefreier Zugriff auf das aktive Farbset für kritische Zeichenpfade.
Material::AcrylicToken themeAcrylic() constMaterial-, Höhenstufen- und adaptive Layout-Tokens.
QColor themeBackdrop(bool active) constBackdrop-Farbe des Fenster-Chrome für den angegebenen Aktivierungszustand.
virtual void onThemeUpdated()Wird nach einer Änderung des globalen Themes aufgerufen.
Typen und Aliase
struct ColorsAn 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.
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Installiert eine verwaltete direkte Bindung auf diesem QWidget-Host.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installiert einen C++-Ausdruck mit expliziten Abhängigkeiten auf diesem QWidget-Host.
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