Auf dieser Seite

QWaylandWlShellSurface Class

Die Klasse „QWaylandWlShellSurface“ stellt einer Oberfläche Compositor-spezifische Funktionen im Desktop-Stil zur Verfügung. Mehr...

Header: #include <QWaylandWlShellSurface>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
In QML: WlShellSurface
Erbt von: QWaylandShellSurfaceTemplate

Öffentliche Typen

enum ResizeEdge { NoneEdge, TopEdge, BottomEdge, LeftEdge, TopLeftEdge, …, BottomRightEdge }

Eigenschaften

Öffentliche Funktionen

QWaylandWlShellSurface()
QWaylandWlShellSurface(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &res)
QString className() const
void initialize(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &resource)
void sendConfigure(const QSize &size, QWaylandWlShellSurface::ResizeEdge edges)
void sendPopupDone()
QWaylandWlShell *shell() const
QWaylandSurface *surface() const
QString title() const

Öffentliche Slots

void ping()

Signale

Statische öffentliche Mitglieder

QWaylandWlShellSurface *fromResource(wl_resource *resource)

Ausführliche Beschreibung

Diese Klasse ist Teil der Erweiterung „ QWaylandWlShell “ und bietet die Möglichkeit, die Funktionalität eines bestehenden „ QWaylandSurface “ um Funktionen zu erweitern, die für Compositoren im Desktop-Stil spezifisch sind, wie beispielsweise das Ändern der Größe und das Verschieben der Oberfläche.

Sie entspricht der Wayland-Schnittstelle „ wl_shell_surface “.

Dokumentation zum Mitgliedstyp

enum QWaylandWlShellSurface::ResizeEdge

Dieser Enum-Typ bietet die Möglichkeit, eine Kante oder Ecke der Oberfläche anzugeben.

KonstanteWertBeschreibung
QWaylandWlShellSurface::NoneEdge0Keine Kante.
QWaylandWlShellSurface::TopEdge1Die obere Kante.
QWaylandWlShellSurface::BottomEdge2Die untere Kante.
QWaylandWlShellSurface::LeftEdge4Die linke Kante.
QWaylandWlShellSurface::TopLeftEdge5Die obere linke Ecke.
QWaylandWlShellSurface::BottomLeftEdge6Die linke untere Ecke.
QWaylandWlShellSurface::RightEdge8Die rechte Kante.
QWaylandWlShellSurface::TopRightEdge9Die rechte obere Ecke.
QWaylandWlShellSurface::BottomRightEdge10Die rechte untere Ecke.

Dokumentation zu den Eigenschaften

[read-only] className : QString

Diese Eigenschaft enthält den Klassennamen von „ QWaylandWlShellSurface “.

Zugriffsfunktionen:

QString className() const

Notifier-Signal:

void classNameChanged()

[read-only] shell : QWaylandWlShell*

Diese Eigenschaft enthält die Shell, die diesem QWaylandWlShellSurface zugeordnet ist.

Zugriffsfunktionen:

QWaylandWlShell *shell() const

Benachrichtigungssignal:

void shellChanged()

[read-only] surface : QWaylandSurface*

Diese Eigenschaft enthält die Oberfläche, die diesem „ QWaylandWlShellSurface “ zugeordnet ist.

Zugriffsfunktionen:

QWaylandSurface *surface() const

Benachrichtigungssignal:

void surfaceChanged()

[read-only] title : QString

Diese Immobilie trägt den Titel „ QWaylandWlShellSurface “.

Zugriffsfunktionen:

QString title() const

Notifier-Signal:

void titleChanged()

Dokumentation der Member-Funktionen

QWaylandWlShellSurface::QWaylandWlShellSurface()

Erstellt eine `QWaylandWlShellSurface`.

QWaylandWlShellSurface::QWaylandWlShellSurface(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &res)

Erstellt eine `QWaylandWlShellSurface` für ` surface ` und initialisiert diese mit dem angegebenen ` shell ` und der Ressource ` res`.

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

Gibt das „ QWaylandWlShellSurface “-Objekt zurück, das mit dem angegebenen „ resource “ verknüpft ist, oder „null“, falls kein solches Objekt existiert.

[invokable] void QWaylandWlShellSurface::initialize(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &resource)

Initialisiert das „ QWaylandWlShellSurface “ und ordnet ihm die angegebenen „ shell “, „ surface “ und „ resource “ zu.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[slot] void QWaylandWlShellSurface::ping()

Sendet ein Ping-Ereignis an den Client. Wenn der Client auf das Ereignis antwortet, wird das Pong-Signal gesendet.

[invokable] void QWaylandWlShellSurface::sendConfigure(const QSize &size, QWaylandWlShellSurface::ResizeEdge edges)

Sendet ein Konfigurationsereignis an den Client und schlägt vor, die Größe seiner Oberfläche auf die angegebene Größe ` size` anzupassen. Die ` edges ` geben einen Hinweis darauf, wie die Größe der Oberfläche angepasst wurde.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QWaylandWlShellSurface::sendPopupDone()

Sendet ein „popup_done“-Ereignis an den Client, um anzuzeigen, dass der Benutzer an einer Stelle außerhalb der Oberflächen des Clients geklickt hat.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

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