XdgPopup QML Type
XdgPopup repräsentiert die popup-spezifischen Teile einer xdg-Oberfläche. Mehr...
| Import Statement: | import QtWayland.Compositor.XdgShell |
| In C++: | QWaylandXdgPopup |
Eigenschaften
- anchorEdges : enumeration
- anchorRect : rect
- configuredGeometry : rect
- flipConstraints : enumeration
- gravityEdges : rect
- offset : point
- parentXdgSurface : XdgSurface
- positionerSize : size
- resizeConstraints : enumeration
- slideConstraints : enumeration
- unconstrainedPosition : point
- xdgSurface : XdgSurface
Methoden
- int sendConfigure(rect geometry)
- void sendPopupDone()
Ausführliche Beschreibung
Dieser Typ ist Teil der Erweiterung „ XdgShell “ und bietet die Möglichkeit, die Funktionalität eines „ XdgSurface “ um Funktionen zu erweitern, die für Menüs im Desktop-Stil für eine xdg-Oberfläche spezifisch sind.
Er entspricht der Wayland-Schnittstelle „ xdg_popup “.
Dokumentation zu den Eigenschaften
anchorEdges : enumeration [read-only]
Diese Eigenschaft enthält die Menge der Kanten des Ankerrechtecks, relativ zu denen die untergeordnete Fläche platziert werden soll. Wenn in einer Richtung keine Kanten angegeben sind, sollte der Ankerpunkt zwischen den Kanten zentriert werden.
Die möglichen Werte sind:
| Konstant | Beschreibung |
|---|---|
Qt.TopEdge | Die obere Kante des Rechtecks. |
Qt.LeftEdge | Die linke Kante des Rechtecks. |
Qt.RightEdge | Die rechte Kante des Rechtecks. |
Qt.BottomEdge | Die untere Kante des Rechtecks. |
anchorRect : rect [read-only]
Das Ankerrechteck relativ zur Geometrie des übergeordneten Fensters, an dem die untergeordnete Fläche ausgerichtet werden soll.
configuredGeometry : rect [read-only]
Die Fenstergeometrie, die das Popup im „configure“-Ereignis erhalten hat. Bezogen auf die obere linke Ecke der übergeordneten Fläche.
flipConstraints : enumeration [read-only]
Diese Eigenschaft legt fest, in welche Ausrichtungen das untergeordnete Element gedreht werden soll, damit es auf den Bildschirm passt.
Mögliche Werte:
| Konstante | Beschreibung |
|---|---|
Qt.Horizontal | Horizontal |
Qt.Vertical | Vertikal |
gravityEdges : rect [read-only]
Legt fest, in welcher Richtung die Fläche relativ zum Ankerpunkt ausgerichtet werden soll.
Die möglichen Werte sind:
| Konstant | Beschreibung |
|---|---|
Qt.TopEdge | Die Oberfläche soll zum oberen Bildschirmrand hin gleiten. |
Qt.LeftEdge | Die Oberfläche soll zur linken Seite des Bildschirms gleiten. |
Qt.RightEdge | Die Fläche soll zur rechten Bildschirmseite hin gleiten. |
Qt.BottomEdge | Die Fläche soll zum unteren Bildschirmrand hin gleiten. |
offset : point [read-only]
Die Position relativ zur Position des Ankers auf dem Ankerrechteck und des Ankers auf der Oberfläche.
parentXdgSurface : XdgSurface [read-only]
Diese Eigenschaft enthält die „ XdgSurface “, die dem übergeordneten Element dieses „ XdgPopup “ zugeordnet ist.
positionerSize : size [read-only]
Die vom Positionierungsobjekt für die Fenstergeometrie angeforderte Größe.
resizeConstraints : enumeration [read-only]
Diese Eigenschaft legt fest, in welchen Ausrichtungen die untergeordnete Komponente ihre Größe anpassen soll, damit sie auf den Bildschirm passt.
Mögliche Werte:
| Konstante | Beschreibung |
|---|---|
Qt.Horizontal | Horizontal |
Qt.Vertical | Vertikal |
slideConstraints : enumeration [read-only]
Diese Eigenschaft legt fest, in welche Richtungen das untergeordnete Element verschoben werden soll, damit es auf den Bildschirm passt.
Mögliche Werte:
| Konstante | Beschreibung |
|---|---|
Qt.Horizontal | Horizontal |
Qt.Vertical | Vertikal |
unconstrainedPosition : point [read-only]
Die Position der Oberfläche relativ zur Geometrie des übergeordneten Fensters, wenn die Oberfläche nicht fixiert ist. D. h. wenn sie nicht so verschoben wird, dass sie in den Bildschirm passt, oder Ähnliches.
xdgSurface : XdgSurface [read-only]
Diese Eigenschaft enthält den XdgSurface, der mit diesem XdgPopup verknüpft ist.
Methodendokumentation
int sendConfigure(rect geometry)
Sendet ein „configure“-Ereignis an den Client. ` geometry ` enthält die Fenstergeometrie relativ zur oberen linken Ecke der Fenstergeometrie der übergeordneten Oberfläche.
Dadurch wird implizit auch ein Konfigurationsereignis an die entsprechende ` XdgSurface ` gesendet.
void sendPopupDone()
Das Popup schließen. Gemäß dem Protokoll „ xdg-shell “ sollte dies dazu führen, dass der Client das Popup schließt.
© 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.
