Sur cette page

XdgPopup QML Type

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

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgPopup

Propriétés

Méthodes

Description détaillée

Ce type fait partie de l'extension XdgShell et permet d'étendre les fonctionnalités d'un XdgSurface avec des fonctionnalités spécifiques aux menus de type bureau pour une surface xdg.

Il correspond à l’interface Wayland xdg_popup.

Documentation des propriétés

anchorEdges : enumeration [read-only]

Cette propriété contient 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 donnée, le point d'ancrage doit être centré entre les arêtes.

Les valeurs possibles sont les suivantes :

ConstanteDescription
Qt.TopEdgeLe bord supérieur du rectangle.
Qt.LeftEdgeLe bord gauche du rectangle.
Qt.RightEdgeLe bord droit du rectangle.
Qt.BottomEdgeLe bord inférieur du rectangle.

anchorRect : rect [read-only]

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

configuredGeometry : rect [read-only]

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.

flipConstraints : enumeration [read-only]

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

Valeurs possibles :

ConstanteDescription
Qt.HorizontalHorizontal
Qt.VerticalVerticale

gravityEdges : rect [read-only]

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

Les valeurs possibles sont :

ConstanteDescription
Qt.TopEdgeLa surface doit glisser vers le haut de l'écran.
Qt.LeftEdgeLa surface doit glisser vers la gauche de l'écran.
Qt.RightEdgeLa surface doit glisser vers la droite de l'écran.
Qt.BottomEdgeLa surface doit glisser vers le bas de l'écran.

offset : point [read-only]

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

parentXdgSurface : XdgSurface [read-only]

Cette propriété contient l'XdgSurface e associé au parent de cet XdgPopup.

positionerSize : size [read-only]

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

resizeConstraints : enumeration [read-only]

Cette propriété définit les orientations selon lesquelles l'élément enfant doit être redimensionné pour s'adapter à l'écran.

Valeurs possibles :

ConstanteDescription
Qt.HorizontalHorizontale
Qt.VerticalVerticale

slideConstraints : enumeration [read-only]

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

Valeurs possibles :

ConstanteDescription
Qt.HorizontalHorizontale
Qt.VerticalVerticale

unconstrainedPosition : point [read-only]

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.

xdgSurface : XdgSurface [read-only]

Cette propriété contient l'XdgSurface associée à cette XdgPopup.

Documentation des méthodes

int sendConfigure(rect geometry)

Envoie un événement « configure » au client. L'objet ` 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 de configuration à l'XdgSurface correspondante.

void sendPopupDone()

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

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