Sur cette page

XdgPopup QML Type

XdgPopup représente les parties spécifiques d'une surface xdg. Plus d'informations...

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 fournit un moyen d'étendre les fonctionnalités d'un XdgSurface avec des caractéristiques spécifiques aux menus de style bureau pour une surface xdg.

Il correspond à l'interface Wayland xdg_popup.

Documentation sur les propriétés

anchorEdges : enumeration [read-only]

Cette propriété contient 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.

Les valeurs possibles sont les suivantes

ConstantDescription
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]

Le rectangle d'ancrage par rapport à la géométrie de la fenêtre parente sur lequel la surface enfant doit être placée.

configuredGeometry : rect [read-only]

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.

flipConstraints : enumeration [read-only]

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

Valeurs possibles :

ConstanteDescription de la propriété
Qt.HorizontalHorizontal
Qt.VerticalVertical

gravityEdges : rect [read-only]

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

Les valeurs possibles sont les suivantes

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'ancre sur le rectangle d'ancrage et de l'ancre sur la surface.

parentXdgSurface : XdgSurface [read-only]

Cette propriété contient le XdgSurface associé au parent de ce 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 dans lesquelles l'enfant doit être redimensionné pour s'adapter à l'écran.

Valeurs possibles :

ConstanteDescription de la propriété
Qt.HorizontalHorizontal
Qt.VerticalVertical

slideConstraints : enumeration [read-only]

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

Valeurs possibles :

ConstanteDescription de la propriété
Qt.HorizontalHorizontal
Qt.VerticalVertical

unconstrainedPosition : point [read-only]

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.

xdgSurface : XdgSurface [read-only]

Cette propriété contient le XdgSurface associé à ce XdgPopup.

Documentation de la méthode

int sendConfigure(rect 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.

Cela envoie implicitement un événement de configuration à l'adresse XdgSurface correspondante.

void sendPopupDone()

Désactiver la fenêtre contextuelle. Selon le protocole xdg-shell, le client devrait détruire 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.