Sur cette page

QWaylandXdgPopup Class

La classe QWaylandXdgPopup représente les parties spécifiques aux popups d'une surface xdg. Plus d'informations...

En-tête : #include <QWaylandXdgPopup>
CMake : find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake : QT += waylandcompositor
En QML : XdgPopup
Héritages : QObject

Propriétés

Fonctions publiques

Qt::Edges anchorEdges() const
QRect anchorRect() const
QRect configuredGeometry() const
Qt::Orientations flipConstraints() const
Qt::Edges gravityEdges() const
QPoint offset() const
QWaylandXdgSurface *parentXdgSurface() const
QSize positionerSize() const
Qt::Orientations resizeConstraints() const
uint sendConfigure(const QRect &geometry)
void sendPopupDone()
Qt::Orientations slideConstraints() const
QPoint unconstrainedPosition() const
QWaylandXdgSurface *xdgSurface() const

Signaux

Membres publics statiques

QWaylandSurfaceRole *role()

Description détaillée

Cette classe fait partie de l'extension QWaylandXdgShell et fournit un moyen d'étendre la fonctionnalité d'une QWaylandXdgSurface avec des caractéristiques spécifiques aux menus de style bureau pour une surface xdg.

Elle correspond à l'interface Wayland xdg_popup.

Documentation sur les propriétés

[read-only] anchorEdges : const Qt::Edges

Renvoie l'ensemble des bords du rectangle d'ancrage par rapport auxquels la surface enfant doit être placée. Si aucun bord n'est spécifié dans une direction, le point d'ancrage doit être centré entre les bords.

Fonctions d'accès :

Qt::Edges anchorEdges() const

[read-only] anchorRect : const QRect

Renvoie le rectangle d'ancrage relatif à la géométrie de la fenêtre parentale par rapport auquel la surface enfant doit être placée.

Fonctions d'accès :

QRect anchorRect() const

[read-only] configuredGeometry : QRect

Géométrie de la fenêtre de la fenêtre contextuelle reçue lors de l'événement de configuration. Relative au coin supérieur gauche de la surface parente.

Fonctions d'accès :

QRect configuredGeometry() const

Signal du notificateur :

void configuredGeometryChanged()

[read-only] flipConstraints : const Qt::Orientations

Cette propriété contient les orientations dans lesquelles l'enfant doit se retourner pour s'adapter à l'écran.

Fonctions d'accès :

Qt::Orientations flipConstraints() const

[read-only] gravityEdges : const Qt::Edges

Spécifie la direction dans laquelle la surface doit être positionnée par rapport au point d'ancrage.

Fonctions d'accès :

Qt::Edges gravityEdges() const

[read-only] offset : const QPoint

Renvoie la position de la surface par rapport à la position de l'ancre sur le rectangle d'ancrage et de l'ancre sur la surface.

Fonctions d'accès :

QPoint offset() const

[read-only] parentXdgSurface : QWaylandXdgSurface* const

Cette propriété contient le QWaylandXdgSurface associé au parent de ce QWaylandXdgPopup.

Fonctions d'accès :

QWaylandXdgSurface *parentXdgSurface() const

[read-only] positionerSize : const QSize

Renvoie la taille demandée pour la géométrie de la fenêtre par l'objet positionneur.

Fonctions d'accès :

QSize positionerSize() const

[read-only] resizeConstraints : const Qt::Orientations

Cette propriété contient les orientations dans lesquelles l'enfant doit être redimensionné pour s'adapter à l'écran.

Fonctions d'accès :

Qt::Orientations resizeConstraints() const

[read-only] slideConstraints : const Qt::Orientations

Cette propriété contient les orientations dans lesquelles l'enfant doit glisser pour s'adapter à l'écran.

Fonctions d'accès :

Qt::Orientations slideConstraints() const

[read-only] unconstrainedPosition : const QPoint

La position de la surface par rapport à la géométrie de la fenêtre parente si la surface n'est pas contrainte. C'est-à-dire qu'elle n'est pas déplacée pour s'adapter à l'intérieur de l'écran ou d'une manière similaire.

Fonctions d'accès :

QPoint unconstrainedPosition() const

[read-only] xdgSurface : QWaylandXdgSurface* const

Cette propriété contient le QWaylandXdgSurface associé à ce QWaylandXdgPopup.

Fonctions d'accès :

QWaylandXdgSurface *xdgSurface() const

Documentation des fonctions membres

[static] QWaylandSurfaceRole *QWaylandXdgPopup::role()

Renvoie le rôle de la surface pour le QWaylandPopup.

[invokable] uint QWaylandXdgPopup::sendConfigure(const QRect &geometry)

Envoie un événement de configuration au client. geometry contient la géométrie de la fenêtre par rapport au coin supérieur gauche de la géométrie de la fenêtre de la surface parente.

Cette fonction envoie implicitement un événement de configuration à l'adresse QWaylandXdgSurface correspondante.

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

[invokable] void QWaylandXdgPopup::sendPopupDone()

Désactiver la fenêtre contextuelle. Selon le protocole xdg-shell, cette fonction devrait amener le client à détruire la fenêtre contextuelle.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir 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.