XdgToplevel QML Type

XdgToplevel stellt die fensterspezifischen Teile einer Xdg-Oberfläche dar. Mehr...

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgToplevel

Eigenschaften

Methoden

Detaillierte Beschreibung

Dieser Typ ist Teil der XdgShell -Erweiterung und bietet eine Möglichkeit, die Funktionalität von XdgSurface mit spezifischen Funktionen für Desktop-Fenster zu erweitern.

Er entspricht der Wayland-Schnittstelle xdg_toplevel.

Eigenschaft Dokumentation

activated : bool [read-only]

Diese Eigenschaft gibt an, ob das Toplevel sich selbst als Eingabefokus zeichnet.


appId : string [read-only]

Diese Eigenschaft enthält die App-ID des XdgToplevel.


decorationMode : enumeration [read-only]

Diese Eigenschaft enthält den aktuellen Fensterdekorationsmodus für diese Toplevel.

Die möglichen Werte sind:

KonstantBeschreibung
XdgToplevel.ServerSideDecorationDer Compositor soll Fensterdekorationen zeichnen.
XdgToplevel.ClientSideDecorationDer Client sollte Fensterdekorationen zeichnen.

Siehe auch XdgDecorationManagerV1.


fullscreen : bool [read-only]

Diese Eigenschaft gibt an, ob der Client bestätigt hat, dass er im Vollbildmodus dargestellt werden soll.


maxSize : size [read-only]

Diese Eigenschaft enthält die maximale Größe von XdgToplevel, wie sie vom Client angefordert wurde.

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


maximized : bool [read-only]

Diese Eigenschaft gibt an, ob der Client bestätigt hat, dass er maximiert werden soll.


minSize : size [read-only]

Diese Eigenschaft enthält die vom Kunden geforderte Mindestgröße von XdgToplevel.

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


Diese Eigenschaft gibt an, ob das Toplevel andere Fenster vom Empfang von Eingaben abhält.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.


parentToplevel : XdgToplevel [read-only]

Diese Eigenschaft enthält das XdgToplevel parent dieses XdgToplevel.


resizing : bool [read-only]

Diese Eigenschaft gibt an, ob der Client bestätigt hat, dass er in der Größe verändert wird.


title : string [read-only]

Diese Eigenschaft enthält den Titel des XdgToplevel.


xdgSurface : XdgSurface [read-only]

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


Methode Dokumentation

void sendClose()

Sendet ein Schließereignis an den Client. Der Client kann sich entscheiden, das Ereignis zu ignorieren.


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

Sendet ein configure-Ereignis an den Client. size enthält die Pixelgröße der Oberfläche. Eine Größe von Null bedeutet, dass der Client die Größe frei bestimmen kann. Bekannte states werden in XdgToplevel::State aufgezählt.


void sendFullscreen(size size)

Bequemlichkeit für das Senden eines configure-Ereignisses mit dem Vollbildstatus, maximiert und Größenänderung entfernt. Der aktivierte Zustand wird in seinem aktuellen Zustand belassen.

size ist die neue Größe des Fensters.

Siehe auch sendUnmaximized.


void sendMaximized(size size)

Bequemlichkeit für das Senden eines configure-Ereignisses mit dem Status maximiert und Vollbild und Größenanpassung entfernt. Der aktivierte Zustand wird in seinem aktuellen Zustand belassen.

size ist die neue Größe des Fensters.


void sendResizing(size maxSize)

Convenience für das Senden eines configure-Ereignisses mit gesetztem Größenänderungsstatus und entferntem maximized und fullscreen. Der aktivierte Zustand wird in seinem aktuellen Zustand belassen.

maxSize ist die neue Größe des Fensters.


void sendUnmaximized(size size)

Convenience für das Senden eines configure-Ereignisses, bei dem die Zustände maximized, fullscreen und resizing entfernt werden und fullscreen und resizing entfernt werden. Der aktivierte Zustand wird in seinem aktuellen Zustand belassen.

size ist die neue Größe des Fensters. Wenn size gleich Null ist, entscheidet der Client über die Größe.


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

Convenience zur Berechnung der neuen Größe unter Berücksichtigung der aktuellen size, einer delta und der edges, die beim Ziehen aktiv ist.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.