Sur cette page

QWaylandXdgSurface Class

La classe QWaylandXdgSurface offre à une surface xdg des fonctionnalités spécifiques au compositeur, de type bureau. En savoir plus...

En-tête : #include <QWaylandXdgSurface>
CMake : find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake : QT += waylandcompositor
En QML : XdgSurface
Hérite de : QWaylandShellSurfaceTemplate

Propriétés

Fonctions publiques

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

Signaux

Membres publics statiques

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

Description détaillée

Cette classe fait partie de l’extension QWaylandXdgShell et permet d’étendre les fonctionnalités d’une surface existante ( QWaylandSurface ) avec des fonctionnalités spécifiques aux compositeurs de type bureau, telles que le redimensionnement et le déplacement de la surface.

Elle correspond à l’interface Wayland xdg_surface.

Documentation des propriétés

Cette propriété regroupe les propriétés et les méthodes spécifiques à la fenêtre contextuelle QWaylandXdgSurface.

Fonctions d'accès :

QWaylandXdgPopup *popup() const

Signal de notification :

void popupCreated()

Voir également QWaylandXdgSurface::toplevel et QWaylandXdgShell::popupCreated.

[read-only] shell : QWaylandXdgShell*

Cette propriété contient le shell associé à cette QWaylandXdgSurface.

Fonctions d'accès :

QWaylandXdgShell *shell() const

Signal de notification :

void shellChanged()

[read-only] surface : QWaylandSurface*

Cette propriété contient la surface associée à cette QWaylandXdgSurface.

Fonctions d'accès :

QWaylandSurface *surface() const

Signal de notification :

void surfaceChanged()

[read-only] toplevel : QWaylandXdgToplevel*

Cette propriété regroupe les propriétés et les méthodes spécifiques à l'QWaylandXdgSurface de niveau supérieur.

Fonctions d'accès :

QWaylandXdgToplevel *toplevel() const

Signal de notification :

void toplevelCreated()

Voir également QWaylandXdgSurface::popup et QWaylandXdgShell::toplevelCreated.

[read-only] windowGeometry : QRect

Cette propriété contient la géométrie de la fenêtre de l'QWaylandXdgSurface. La géométrie de la fenêtre décrit les limites visibles de celle-ci du point de vue de l'utilisateur. Elle inclut les barres de titre et les bordures si elles sont dessinées par le client, mais exclut les ombres portées. Elle est destinée à être utilisée pour l'alignement et la disposition en mosaïque des fenêtres.

Fonctions d'accès :

QRect windowGeometry() const

Signal de notification :

void windowGeometryChanged()

Documentation des fonctions membres

[explicit] QWaylandXdgSurface::QWaylandXdgSurface()

Crée un objet `QWaylandXdgSurface`.

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

Crée un objet `QWaylandXdgSurface` pour ` surface ` et l'initialise avec les paramètres suivants : ` xdgShell`, ` surface` et la ressource ` res`.

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

Renvoie l'QWaylandXdgSurface correspondant à l'resource.

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

Initialise l'QWaylandXdgSurface, en l'associant aux éléments xdgShell, surface et resource fournis.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

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

Renvoie l'interface Wayland correspondant à l'QWaylandXdgSurface.

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