Back to Qt.io
Contact Us Blog Download Qt

QWaylandXdgToplevel Class

Die Klasse QWaylandXdgToplevel repräsentiert die Toplevel-Fenster-spezifischen Teile einer xdg-Oberfläche. Mehr...

Kopfzeile: #include <QWaylandXdgToplevel>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
In QML: XdgToplevel
Vererbt: QObject

Öffentliche Typen

enum DecorationMode { ServerSideDecoration, ClientSideDecoration }

Eigenschaften

Öffentliche Funktionen

QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)
bool activated() const
QString appId() const
QWaylandXdgToplevel::DecorationMode decorationMode() const
bool fullscreen() const
bool isModal() const
QSize maxSize() const
bool maximized() const
QSize minSize() const
QWaylandXdgToplevel *parentToplevel() const
bool resizing() const
void sendClose()
uint sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states)
uint sendFullscreen(const QSize &size)
uint sendMaximized(const QSize &size)
uint sendResizing(const QSize &maxSize)
uint sendUnmaximized(const QSize &size = QSize(0, 0))
QSize sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const
QString title() const
QWaylandXdgSurface *xdgSurface() const

Signale

void activatedChanged()
void appIdChanged()
void decorationModeChanged()
void fullscreenChanged()
void maxSizeChanged()
void maximizedChanged()
void minSizeChanged()
void modalChanged()
void parentToplevelChanged()
void resizingChanged()
void statesChanged()
void titleChanged()

Statische öffentliche Mitglieder

QWaylandXdgToplevel *fromResource(wl_resource *resource)
QWaylandSurfaceRole *role()

Detaillierte Beschreibung

Diese Klasse ist Teil der QWaylandXdgShell -Erweiterung und bietet eine Möglichkeit, die Funktionalität von QWaylandXdgSurface mit spezifischen Funktionen für Desktop-ähnliche Fenster zu erweitern.

Sie entspricht der Wayland-Schnittstelle xdg_toplevel.

Mitgliedstyp Dokumentation

enum QWaylandXdgToplevel::DecorationMode

Dieser Enum-Typ wird verwendet, um den Fensterdekorationsmodus für Toplevel-Fenster anzugeben.

KonstanteWertBeschreibung
QWaylandXdgToplevel::ServerSideDecoration2Der Compositor soll Fensterdekorationen zeichnen.
QWaylandXdgToplevel::ClientSideDecoration1Der Client sollte Fensterdekorationen zeichnen.

Dokumentation der Eigenschaft

[read-only] activated : const bool

Diese Eigenschaft gibt an, ob die Toplevel selbst den Eingabefokus hat.

Zugriffsfunktionen:

bool activated() const

Melder-Signal:

void activatedChanged()

[read-only] appId : const QString

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

Zugriffsfunktionen:

QString appId() const

Benachrichtigungssignal:

void appIdChanged()

[read-only] decorationMode : const enum DecorationMode

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

Zugriffsfunktionen:

QWaylandXdgToplevel::DecorationMode decorationMode() const

Benachrichtigungssignal:

void decorationModeChanged()

Siehe auch QWaylandXdgDecorationManagerV1.

[read-only] fullscreen : const bool

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

Zugriffsfunktionen:

bool fullscreen() const

Benachrichtigungssignal:

void fullscreenChanged()

[read-only] maxSize : const QSize

Diese Eigenschaft gibt die maximale Größe von QWaylandXdgToplevel an.

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

Zugriffsfunktionen:

QSize maxSize() const

Benachrichtigungssignal:

void maxSizeChanged()

[read-only] maximized : const bool

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

Zugriffsfunktionen:

bool maximized() const

Benachrichtigungssignal:

void maximizedChanged()

[read-only] minSize : const QSize

Diese Eigenschaft gibt die Mindestgröße von QWaylandXdgToplevel an.

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

Zugriffsfunktionen:

QSize minSize() const

Benachrichtigungssignal:

void minSizeChanged()

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

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Zugriffsfunktionen:

bool isModal() const

Notifier-Signal:

void modalChanged()

[read-only] parentToplevel : QWaylandXdgToplevel* const

Diese Eigenschaft enthält die XdgToplevel parent dieser XdgToplevel.

Zugriffsfunktionen:

QWaylandXdgToplevel *parentToplevel() const

Benachrichtigungssignal:

void parentToplevelChanged()

[read-only] resizing : const bool

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

Zugriffsfunktionen:

bool resizing() const

Benachrichtigungssignal:

void resizingChanged()

[read-only] states : const QList<int>

Diese Eigenschaft enthält die letzten Zustände, die der Client für dieses QWaylandToplevel bestätigt hat.

Notifier-Signal bestätigt hat:

void statesChanged()

[read-only] title : const QString

Diese Eigenschaft enthält den Titel der QWaylandXdgToplevel.

Zugriffsfunktionen:

QString title() const

Benachrichtigungssignal:

void titleChanged()

[read-only] xdgSurface : QWaylandXdgSurface* const

Diese Eigenschaft enthält die QWaylandXdgSurface für diese QWaylandXdgToplevel.

Zugriffsfunktionen:

QWaylandXdgSurface *xdgSurface() const

Dokumentation der Mitgliedsfunktionen

[explicit] QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)

Konstruiert ein QWaylandXdgToplevel für die angegebenen xdgSurface und resource.

[static] QWaylandXdgToplevel *QWaylandXdgToplevel::fromResource(wl_resource *resource)

Gibt die QWaylandXdgToplevel zurück, die der resource entspricht.

[static] QWaylandSurfaceRole *QWaylandXdgToplevel::role()

Gibt die Oberflächenrolle für das QWaylandToplevel zurück.

[invokable] void QWaylandXdgToplevel::sendClose()

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

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

uint QWaylandXdgToplevel::sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states)

Sendet ein Konfigurationsereignis an den Client. Der Parameter 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 QWaylandXdgToplevel::State aufgezählt.

[invokable] uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)

Convenience 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.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch sendUnmaximized.

[invokable] uint QWaylandXdgToplevel::sendMaximized(const QSize &size)

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

size ist die neue Größe des Fensters.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] uint QWaylandXdgToplevel::sendResizing(const QSize &maxSize)

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

maxSize ist die neue Größe des Fensters.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))

Convenience für das Senden eines configure-Ereignisses, bei dem die Zustände maximiert, Vollbild und Größenänderung 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.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] QSize QWaylandXdgToplevel::sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const

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

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

© 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.