QWaylandXdgPopup Class

Die Klasse QWaylandXdgPopup repräsentiert die popup-spezifischen Teile einer xdg-Oberfläche. Mehr...

Kopfzeile: #include <QWaylandXdgPopup>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
In QML: XdgPopup
Vererbt: 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

Statische öffentliche Mitglieder

QWaylandSurfaceRole *role()

Detaillierte Beschreibung

Diese Klasse ist Teil der QWaylandXdgShell -Erweiterung und bietet eine Möglichkeit, die Funktionalität von QWaylandXdgSurface mit spezifischen Funktionen für Desktop-ähnliche Menüs für eine xdg-Oberfläche zu erweitern.

Sie entspricht der Wayland-Schnittstelle xdg_popup.

Dokumentation der Eigenschaften

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

Gibt die Menge der Kanten auf dem Anker-Rect zurück, zu denen die untergeordnete Fläche relativ platziert werden soll. Wenn keine Kanten in einer Richtung 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 übergeordneten Fenstergeometrie zurück, zu dem die untergeordnete Fläche platziert werden soll.

Zugriffsfunktionen:

QRect anchorRect() const

[read-only] configuredGeometry : const QRect

Die Fenstergeometrie, die das Popup im configure-Ereignis erhalten hat. Bezogen auf die linke obere Ecke der übergeordneten Oberfläche.

Zugriffsfunktionen:

QRect configuredGeometry() const

Melder-Signal:

void configuredGeometryChanged()

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

Diese Eigenschaft enthält die Ausrichtungen, in denen das Kind sich drehen soll, um in den Bildschirm zu passen.

Zugriffsfunktionen:

Qt::Orientations flipConstraints() const

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

Gibt an, in welche Richtung die Fläche relativ zum Ankerpunkt positioniert werden soll.

Zugriffsfunktionen:

Qt::Edges gravityEdges() const

[read-only] offset : const QPoint

Gibt die Oberflächenposition 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 mit dem Elternteil dieser QWaylandXdgPopup verbunden ist.

Zugriffsfunktionen:

QWaylandXdgSurface *parentXdgSurface() const

[read-only] positionerSize : const QSize

Gibt die vom Positioner-Objekt für die Fenstergeometrie angeforderte Größe zurück.

Zugriffsfunktionen:

QSize positionerSize() const

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

Diese Eigenschaft enthält die Ausrichtungen, in denen das Kind die Größe ändern soll, um in den Bildschirm zu passen.

Zugriffsfunktionen:

Qt::Orientations resizeConstraints() const

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

Diese Eigenschaft enthält die Ausrichtungen, in die das Kind gleiten soll, um in den Bildschirm zu passen.

Zugriffsfunktionen:

Qt::Orientations slideConstraints() const

[read-only] unconstrainedPosition : const QPoint

Die Position der Oberfläche im Verhältnis zur übergeordneten Fenstergeometrie, wenn die Oberfläche nicht an eine Bedingung geknüpft ist. D.h. wenn sie nicht verschoben wird, um in den Bildschirm zu passen oder ähnliches.

Zugriffsfunktionen:

QPoint unconstrainedPosition() const

[read-only] xdgSurface : QWaylandXdgSurface* const

Diese Eigenschaft enthält die QWaylandXdgSurface, die mit dieser QWaylandXdgPopup verbunden ist.

Zugriffsfunktionen:

QWaylandXdgSurface *xdgSurface() const

Dokumentation der Mitgliedsfunktionen

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

Damit wird implizit auch ein configure-Ereignis an die entsprechende QWaylandXdgSurface gesendet.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QWaylandXdgPopup::sendPopupDone()

Beenden Sie das Popup. Gemäß dem xdg-shell -Protokoll sollte dies den Client veranlassen, das Popup zu zerstören.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

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