QWaylandXdgPopup Class
Die Klasse „QWaylandXdgPopup“ repräsentiert die für Popups spezifischen Teile einer XDG-Oberfläche. Mehr...
| Header: | #include <QWaylandXdgPopup> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| In QML: | XdgPopup |
| Erbt von: | QObject |
Eigenschaften
|
|
Öffentliche Funktionen
| 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 |
Signale
| void | configuredGeometryChanged() |
Statische öffentliche Mitglieder
| QWaylandSurfaceRole * | role() |
Ausführliche Beschreibung
Diese Klasse ist Teil der Erweiterung „ QWaylandXdgShell “ und bietet die Möglichkeit, die Funktionalität eines „ QWaylandXdgSurface “ um Funktionen zu erweitern, die für Menüs im Desktop-Stil für eine xdg-Oberfläche spezifisch sind.
Sie entspricht der Wayland-Schnittstelle „ xdg_popup “.
Dokumentation der Eigenschaften
[read-only] anchorEdges : const Qt::Edges
Gibt die Menge der Kanten des Ankerrechtecks zurück, 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.
Zugriffsfunktionen:
| Qt::Edges | anchorEdges() const |
[read-only] anchorRect : const QRect
Gibt das Ankerrechteck relativ zur Geometrie des übergeordneten Fensters zurück, zu dem die untergeordnete Fläche positioniert werden soll.
Zugriffsfunktionen:
| QRect | anchorRect() const |
[read-only] configuredGeometry : QRect
Die Fenstergeometrie, die das Popup im „configure“-Ereignis erhalten hat. Bezogen auf die obere linke Ecke der übergeordneten Oberfläche.
Zugriffsfunktionen:
| QRect | configuredGeometry() const |
Notifier-Signal:
| void | configuredGeometryChanged() |
[read-only] flipConstraints : const Qt::Orientations
Diese Eigenschaft legt fest, in welche Ausrichtungen das untergeordnete Element gedreht werden soll, damit es auf den Bildschirm passt.
Zugriffsfunktionen:
| Qt::Orientations | flipConstraints() const |
[read-only] gravityEdges : const Qt::Edges
Legt fest, in welche Richtung die Fläche relativ zum Ankerpunkt ausgerichtet werden soll.
Zugriffsfunktionen:
| Qt::Edges | gravityEdges() const |
[read-only] offset : const QPoint
Gibt die Position auf der Oberfläche relativ zur Position des Ankers auf dem Ankerrechteck und des Ankers auf der Oberfläche zurück.
Zugriffsfunktionen:
| QPoint | offset() const |
[read-only] parentXdgSurface : QWaylandXdgSurface* const
Diese Eigenschaft enthält die „ QWaylandXdgSurface “, die dem übergeordneten Element dieses „ QWaylandXdgPopup “ zugeordnet ist.
Zugriffsfunktionen:
| QWaylandXdgSurface * | parentXdgSurface() const |
[read-only] positionerSize : const QSize
Gibt die vom Positionierungsobjekt für die Fenstergeometrie angeforderte Größe zurück.
Zugriffsfunktionen:
| QSize | positionerSize() const |
[read-only] resizeConstraints : const Qt::Orientations
Diese Eigenschaft legt fest, in welchen Ausrichtungen die Größe des untergeordneten Elements angepasst werden soll, damit es auf den Bildschirm passt.
Zugriffsfunktionen:
| Qt::Orientations | resizeConstraints() const |
[read-only] slideConstraints : const Qt::Orientations
Diese Eigenschaft legt fest, in welche Ausrichtungen das untergeordnete Element verschoben werden soll, damit es auf den Bildschirm passt.
Zugriffsfunktionen:
| Qt::Orientations | slideConstraints() const |
[read-only] unconstrainedPosition : const QPoint
Die Position der Oberfläche relativ zur Geometrie des übergeordneten Fensters, sofern die Oberfläche nicht fixiert ist. D. h. wenn sie nicht so verschoben wurde, dass sie in den Bildschirm passt, oder Ähnliches.
Zugriffsfunktionen:
| QPoint | unconstrainedPosition() const |
[read-only] xdgSurface : QWaylandXdgSurface* const
Diese Eigenschaft enthält die „ QWaylandXdgSurface “, die mit diesem „ QWaylandXdgPopup “ verknüpft ist.
Zugriffsfunktionen:
| QWaylandXdgSurface * | xdgSurface() const |
Dokumentation der Member-Funktionen
[static] QWaylandSurfaceRole *QWaylandXdgPopup::role()
Gibt die Oberflächenrolle für das QWaylandPopup zurück.
[invokable] uint QWaylandXdgPopup::sendConfigure(const QRect &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 „configure“-Ereignis an das entsprechende ` QWaylandXdgSurface ` gesendet.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe „ Q_INVOKABLE “.
[invokable] void QWaylandXdgPopup::sendPopupDone()
Das Popup schließen. Gemäß dem Protokoll „ xdg-shell “ sollte dies dazu führen, dass der Client das Popup schließt.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe 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.
