QWaylandXdgPopup Class

The QWaylandXdgPopup class represents the popup specific parts of an xdg surface. More...

Header: #include <QWaylandXdgPopup>
qmake: QT += waylandcompositor
Since: Qt 5.12
Instantiated By: XdgPopup
Inherits: QObject

This class was introduced in Qt 5.12.

Properties

Public Functions

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

Signals

Static Public Members

QWaylandSurfaceRole *role()

Detailed Description

This class is part of the QWaylandXdgShell extension and provides a way to extend the functionality of a QWaylandXdgSurface with features specific to desktop-style menus for an xdg surface.

It corresponds to the Wayland interface xdg_popup.

Property Documentation

anchorEdges : const Qt::Edges

Returns the set of edges on the anchor rect that the child surface should be placed relative to. If no edges are specified in a direction, the anchor point should be centered between the edges.

Access functions:

Qt::Edges anchorEdges() const

anchorRect : const QRect

Returns the anchor rectangle relative to the parent window geometry that the child surface should be placed relative to.

Access functions:

QRect anchorRect() const

configuredGeometry : const QRect

The window geometry the popup received in the configure event. Relative to the upper left corner of the parent surface.

Access functions:

QRect configuredGeometry() const

Notifier signal:

void configuredGeometryChanged()

flipConstraints : const Qt::Orientations

This property holds the orientations in which the child should flip to fit within the screen.

Access functions:

Qt::Orientations flipConstraints() const

gravityEdges : const Qt::Edges

Specifies in what direction the surface should be positioned, relative to the anchor point.

Access functions:

Qt::Edges gravityEdges() const

offset : const QPoint

Returns the surface position relative to the position of the anchor on the anchor rectangle and the anchor on the surface.

Access functions:

QPoint offset() const

parentXdgSurface : QWaylandXdgSurface* const

This property holds the QWaylandXdgSurface associated with the parent of this QWaylandXdgPopup.

Access functions:

QWaylandXdgSurface *parentXdgSurface() const

positionerSize : const QSize

Returns the size requested for the window geometry by the positioner object.

Access functions:

QSize positionerSize() const

resizeConstraints : const Qt::Orientations

This property holds the orientations in which the child should resize to fit within the screen.

Access functions:

Qt::Orientations resizeConstraints() const

slideConstraints : const Qt::Orientations

This property holds the orientations in which the child should slide to fit within the screen.

Access functions:

Qt::Orientations slideConstraints() const

unconstrainedPosition : const QPoint

The position of the surface relative to the parent window geometry if the surface is not constrained. I.e. when not moved to fit inside the screen or similar.

Access functions:

QPoint unconstrainedPosition() const

xdgSurface : QWaylandXdgSurface* const

This property holds the QWaylandXdgSurface associated with this QWaylandXdgPopup.

Access functions:

QWaylandXdgSurface *xdgSurface() const

Member Function Documentation

[static] QWaylandSurfaceRole *QWaylandXdgPopup::role()

Returns the surface role for the QWaylandPopup.

uint QWaylandXdgPopup::sendConfigure(const QRect &geometry)

Sends a configure event to the client. geometry contains the window geometry relative to the upper left corner of the window geometry of the parent surface.

This implicitly sends a configure event to the corresponding QWaylandXdgSurface as well.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

void QWaylandXdgPopup::sendPopupDone()

Dismiss the popup. According to the xdg-shell protocol this should make the client destroy the popup.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

This function was introduced in Qt 5.14.

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