XdgToplevel QML Type

XdgToplevel repräsentiert die fensterbezogenen Teile der obersten Ebene einer Xdg-Oberfläche. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• activated : bool
• appId : string
• decorationMode : enumeration
• fullscreen : bool
• maxSize : size
• maximized : bool
• minSize : size
• modal : bool (since 6.8)
• parentToplevel : XdgToplevel
• resizing : bool
• title : string
• xdgSurface : XdgSurface

Methoden

• void sendClose()
• int sendConfigure(size size, list<int> states)
• void sendFullscreen(size size)
• void sendMaximized(size size)
• void sendResizing(size size)
• void sendUnmaximized(size size)
• size sizeForResize(size size, point delta, uint edges)

Ausführliche Beschreibung

Dieser Typ ist Teil der Erweiterung „ XdgShell “ und bietet die Möglichkeit, die Funktionalität eines „ XdgSurface “ um Funktionen zu erweitern, die für Fenster im Desktop-Stil spezifisch sind.

Er entspricht der Wayland-Schnittstelle „ xdg_toplevel “.

Dokumentation der Eigenschaften

activated : bool [read-only]

Diese Eigenschaft gibt an, ob „toplevel“ sich selbst so darstellt, als hätte es den Eingabefokus.

appId : string [read-only]

Diese Eigenschaft enthält die App-ID des „ XdgToplevel “. Sie entspricht dem „ desktopFileName “ in Qt.

decorationMode : enumeration [read-only]

Diese Eigenschaft enthält den aktuellen Fenstermodus für dieses oberste Fenster.

Mögliche Werte sind:

Siehe auch XdgDecorationManagerV1.

fullscreen : bool [read-only]

Diese Eigenschaft gilt unabhängig davon, ob der Client bestätigt hat, dass der Vollbildmodus aktiviert werden soll.

maxSize : size [read-only]

Diese Eigenschaft enthält die vom Client angeforderte maximale Größe des „ XdgToplevel “.

Dem Compositor steht es frei, diesen Wert zu ignorieren und eine größere Größe anzufordern.

maximized : bool [read-only]

Diese Eigenschaft gilt unabhängig davon, ob der Client bestätigt hat, dass sie maximiert werden soll.

minSize : size [read-only]

Diese Eigenschaft enthält die vom Client angeforderte Mindestgröße des „ XdgToplevel “.

Dem Compositor steht es frei, diesen Wert zu ignorieren und eine kleinere Größe anzufordern.

modal : bool [read-only, since 6.8]

Diese Eigenschaft legt fest, ob „toplevel“ verhindert, dass andere Fenster Eingaben empfangen.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

parentToplevel : XdgToplevel [read-only]

Diese Eigenschaft enthält den übergeordneten Eintrag „ XdgToplevel “ dieses Eintrags „ XdgToplevel “.

resizing : bool [read-only]

Diese Eigenschaft gibt an, ob der Client bestätigt hat, dass seine Größe angepasst wird.

title : string [read-only]

Diese Immobilie trägt den Titel „ XdgToplevel “.

xdgSurface : XdgSurface [read-only]

Diese Eigenschaft enthält die „ XdgSurface “ für diese „ XdgToplevel “.

Methodendokumentation

void sendClose()

Sendet ein Schließereignis an den Client. Der Client kann das Ereignis ignorieren.

int sendConfigure(size size, list<int> states)

Sendet ein Konfigurationsereignis an den Client. „ size “ enthält die Pixelgröße der Oberfläche. Der Wert Null bedeutet, dass der Client die Größe frei festlegen kann.

Mögliche Werte für ` states ` sind:

void sendFullscreen(size size)

Eine bequeme Möglichkeit, ein „configure“-Ereignis zu senden, bei dem der Vollbildmodus gesetzt ist und die Funktionen zum Maximieren und zur Größenänderung deaktiviert sind. Der Aktivierungsstatus bleibt unverändert.

size ist die neue Größe des Fensters.

Siehe auch sendUnmaximized.

void sendMaximized(size size)

Bequeme Möglichkeit, ein Konfigurationsereignis zu senden, bei dem der maximierte Zustand gesetzt ist und die Vollbild- sowie die Größenänderungsoptionen entfernt wurden. Der aktivierte Zustand bleibt unverändert.

size ist die neue Größe des Fensters.

void sendResizing(size size)

Eine bequeme Möglichkeit, ein „configure“-Ereignis zu senden, bei dem der Status „resizing“ gesetzt und die Status „maximized“ sowie „fullscreen“ entfernt werden. Der Status „activated“ bleibt unverändert.

size ist die neue Größe des Fensters.

void sendUnmaximized(size size)

Bequeme Möglichkeit, ein Konfigurationsereignis zu senden, bei dem die Zustände „maximiert“, „Vollbild“ und „Größenänderung“ entfernt werden, wobei „Vollbild“ und „Größenänderung“ entfernt werden. Der aktivierte Zustand bleibt unverändert.

size ist die neue Größe des Fensters. Wenn „ size “ den Wert Null hat, legt der Client die Größe fest.

size sizeForResize(size size, point delta, uint edges)

Eine praktische Methode zur Berechnung der neuen Größe, wenn die aktuellen Werte size, a delta und edges für den Drag bekannt sind.