Back to Qt.io
Contact Us Blog Download Qt

QWaylandXdgSurface Class

Die Klasse QWaylandXdgSurface bietet einer xdg-Oberfläche desktop-spezifische Compositor-Funktionen. Mehr...

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

Eigenschaften

  • popup : QWaylandXdgPopup* const
  • shell : QWaylandXdgShell* const
  • surface : QWaylandSurface* const

Öffentliche Funktionen

QWaylandXdgSurface()
QWaylandXdgSurface(QWaylandXdgShell *xdgShell, QWaylandSurface *surface, const QWaylandResource &res)
void initialize(QWaylandXdgShell *xdgShell, QWaylandSurface *surface, const QWaylandResource &resource)
QWaylandXdgPopup *popup() const
QWaylandXdgShell *shell() const
QWaylandSurface *surface() const
QWaylandXdgToplevel *toplevel() const
QRect windowGeometry() const

Signale

void popupCreated()
void shellChanged()
void surfaceChanged()
void toplevelCreated()
void windowGeometryChanged()

Statische öffentliche Mitglieder

QWaylandXdgSurface *fromResource(wl_resource *resource)
const struct wl_interface *interface()

Detaillierte Beschreibung

Diese Klasse ist Teil der QWaylandXdgShell -Erweiterung und bietet eine Möglichkeit, die Funktionalität eines bestehenden QWaylandSurface mit Funktionen zu erweitern, die speziell für Compositors im Desktop-Stil geeignet sind, wie z. B. Größenänderung und Verschieben der Oberfläche.

Sie entspricht der Wayland-Schnittstelle xdg_surface.

Dokumentation der Eigenschaften

Diese Eigenschaft enthält die Eigenschaften und Methoden, die spezifisch für das Popup QWaylandXdgSurface sind.

Zugriffsfunktionen:

QWaylandXdgPopup *popup() const

Benachrichtigungssignal:

void popupCreated()

Siehe auch QWaylandXdgSurface::toplevel und QWaylandXdgShell::popupCreated.

[read-only] shell : QWaylandXdgShell* const

Diese Eigenschaft enthält die Shell, die mit dieser QWaylandXdgSurface verbunden ist.

Zugriffsfunktionen:

QWaylandXdgShell *shell() const

Benachrichtigungssignal:

void shellChanged()

[read-only] surface : QWaylandSurface* const

Diese Eigenschaft enthält die mit dieser QWaylandXdgSurface verbundene Fläche.

Zugriffsfunktionen:

QWaylandSurface *surface() const

Benachrichtigungssignal:

void surfaceChanged()

[read-only] toplevel : QWaylandXdgToplevel* const

Diese Eigenschaft enthält die Eigenschaften und Methoden, die für die oberste Ebene QWaylandXdgSurface spezifisch sind.

Zugriffsfunktionen:

QWaylandXdgToplevel *toplevel() const

Benachrichtigungssignal:

void toplevelCreated()

Siehe auch QWaylandXdgSurface::popup und QWaylandXdgShell::toplevelCreated.

[read-only] windowGeometry : const QRect

Diese Eigenschaft enthält die Fenstergeometrie von QWaylandXdgSurface. Die Fenstergeometrie beschreibt die sichtbaren Grenzen des Fensters aus der Perspektive des Benutzers. Die Geometrie schließt Titelleisten und Ränder ein, wenn sie vom Client gezeichnet wurden, nicht aber Schlagschatten. Sie ist für das Ausrichten und Kacheln von Fenstern gedacht.

Zugriffsfunktionen:

QRect windowGeometry() const

Benachrichtigungssignal:

void windowGeometryChanged()

Member Function Dokumentation

[explicit] QWaylandXdgSurface::QWaylandXdgSurface()

Konstruiert eine QWaylandXdgSurface.

[explicit] QWaylandXdgSurface::QWaylandXdgSurface(QWaylandXdgShell *xdgShell, QWaylandSurface *surface, const QWaylandResource &res)

Konstruiert eine QWaylandXdgSurface für surface und initialisiert sie mit den angegebenen xdgShell, surface und der Ressource res.

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

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

[invokable] void QWaylandXdgSurface::initialize(QWaylandXdgShell *xdgShell, QWaylandSurface *surface, const QWaylandResource &resource)

Initialisiert QWaylandXdgSurface und verknüpft es mit den angegebenen xdgShell, surface und resource.

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

[static] const struct wl_interface *QWaylandXdgSurface::interface()

Gibt die Wayland-Schnittstelle für die QWaylandXdgSurface zurück.

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