Sur cette page

QWaylandXdgPopup Class

La classe QWaylandXdgPopup représente les éléments spécifiques aux fenêtres contextuelles d'une surface xdg. En savoir plus...

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érite de : 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 permet d'étendre les fonctionnalités d'un QWaylandXdgSurface avec des fonctionnalités spécifiques aux menus de type bureau pour une surface xdg.

Elle correspond à l’interface Wayland xdg_popup.

Documentation des propriétés

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

Renvoie l'ensemble des arêtes du rectangle d'ancrage par rapport auxquelles la surface enfant doit être positionnée. Si aucune arête n'est spécifiée dans une direction, le point d'ancrage doit être centré entre les arêtes.

Fonctions d'accès :

Qt::Edges anchorEdges() const

[read-only] anchorRect : const QRect

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

Fonctions d'accès :

QRect anchorRect() const

[read-only] configuredGeometry : QRect

Géométrie de la fenêtre transmise à la fenêtre contextuelle lors de l'événement « configure ». Par rapport au coin supérieur gauche de la surface parente.

Fonctions d'accès :

QRect configuredGeometry() const

Signal de notification :

void configuredGeometryChanged()

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

Cette propriété définit les orientations vers lesquelles l'élément enfant doit pivoter pour s'adapter à l'écran.

Fonctions d'accès :

Qt::Orientations flipConstraints() const

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

Spécifie dans quelle direction 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'ancrage sur le rectangle d'ancrage et à celle de l'ancrage sur la surface.

Fonctions d'accès :

QPoint offset() const

[read-only] parentXdgSurface : QWaylandXdgSurface* const

Cette propriété contient l'QWaylandXdgSurface e associé au parent de cet 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é définit les orientations selon lesquelles l'élément 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é définit les orientations selon lesquelles l'élément enfant doit se déplacer pour s'adapter à l'écran.

Fonctions d'accès :

Qt::Orientations slideConstraints() const

[read-only] unconstrainedPosition : const QPoint

Position de la surface par rapport à la géométrie de la fenêtre parente lorsque la surface n'est pas contrainte. C'est-à-dire lorsqu'elle n'est pas redimensionnée pour s'adapter à l'écran ou à un espace similaire.

Fonctions d'accès :

QPoint unconstrainedPosition() const

[read-only] xdgSurface : QWaylandXdgSurface* const

Cette propriété contient l'QWaylandXdgSurface e associé à cette QWaylandXdgPopup.

Fonctions d'accès :

QWaylandXdgSurface *xdgSurface() const

Documentation sur les fonctions membres

[static] QWaylandSurfaceRole *QWaylandXdgPopup::role()

Renvoie le rôle de surface associé au QWaylandPopup.

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

Envoie un événement « configure » 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.

Cela envoie également implicitement un événement « configure » à l’ QWaylandXdgSurface correspondant.

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

[invokable] void QWaylandXdgPopup::sendPopupDone()

Fermer la fenêtre contextuelle. Conformément au protocole xdg-shell, cela devrait amener le client à fermer la fenêtre contextuelle.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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.