En esta página

QWaylandXdgPopup Class

La clase QWaylandXdgPopup representa los elementos específicos de las ventanas emergentes de una superficie xdg. Más información...

Encabezado: #include <QWaylandXdgPopup>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
En QML: XdgPopup
Heredan de: QObject

Propiedades

Funciones públicas

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

Señales

Miembros públicos estáticos

QWaylandSurfaceRole *role()

Descripción detallada

Esta clase forma parte de la extensión QWaylandXdgShell y ofrece una forma de ampliar la funcionalidad de un QWaylandXdgSurface con características específicas de los menús de estilo escritorio para una superficie xdg.

Se corresponde con la interfaz de Wayland « xdg_popup ».

Documentación de propiedades

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

Devuelve el conjunto de aristas del rectángulo de anclaje respecto al cual debe colocarse la superficie secundaria. Si no se especifican aristas en una dirección, el punto de anclaje debe situarse en el centro entre las aristas.

Funciones de acceso:

Qt::Edges anchorEdges() const

[read-only] anchorRect : const QRect

Devuelve el rectángulo de anclaje, en relación con la geometría de la ventana principal, respecto al cual debe colocarse la superficie secundaria.

Funciones de acceso:

QRect anchorRect() const

[read-only] configuredGeometry : QRect

La geometría de la ventana que recibió la ventana emergente en el evento «configure». En relación con la esquina superior izquierda de la superficie principal.

Funciones de acceso:

QRect configuredGeometry() const

Señal de notificación:

void configuredGeometryChanged()

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

Esta propiedad establece las orientaciones en las que el elemento secundario debe girarse para ajustarse a la pantalla.

Funciones de acceso:

Qt::Orientations flipConstraints() const

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

Especifica en qué dirección debe colocarse la superficie, con respecto al punto de anclaje.

Funciones de acceso:

Qt::Edges gravityEdges() const

[read-only] offset : const QPoint

Devuelve la posición de la superficie con respecto a la posición del ancla en el rectángulo de anclaje y del ancla en la superficie.

Funciones de acceso:

QPoint offset() const

[read-only] parentXdgSurface : QWaylandXdgSurface* const

Esta propiedad contiene el ` QWaylandXdgSurface ` asociado al elemento padre de este ` QWaylandXdgPopup`.

Funciones de acceso:

QWaylandXdgSurface *parentXdgSurface() const

[read-only] positionerSize : const QSize

Devuelve el tamaño solicitado para la geometría de la ventana por el objeto posicionador.

Funciones de acceso:

QSize positionerSize() const

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

Esta propiedad especifica las orientaciones en las que el elemento secundario debe cambiar de tamaño para ajustarse a la pantalla.

Funciones de acceso:

Qt::Orientations resizeConstraints() const

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

Esta propiedad define las orientaciones en las que el elemento secundario debe desplazarse para ajustarse a la pantalla.

Funciones de acceso:

Qt::Orientations slideConstraints() const

[read-only] unconstrainedPosition : const QPoint

La posición de la superficie respecto a la geometría de la ventana principal si la superficie no está restringida. Es decir, cuando no se ha desplazado para ajustarse al interior de la pantalla o algo similar.

Funciones de acceso:

QPoint unconstrainedPosition() const

[read-only] xdgSurface : QWaylandXdgSurface* const

Esta propiedad contiene el « QWaylandXdgSurface » asociado a este « QWaylandXdgPopup ».

Funciones de acceso:

QWaylandXdgSurface *xdgSurface() const

Documentación de las funciones de miembro

[static] QWaylandSurfaceRole *QWaylandXdgPopup::role()

Devuelve el rol de superficie del QWaylandPopup.

[invokable] uint QWaylandXdgPopup::sendConfigure(const QRect &geometry)

Envía un evento de configuración al cliente. ` geometry ` contiene la geometría de la ventana en relación con la esquina superior izquierda de la geometría de la ventana de la superficie principal.

Esto también envía implícitamente un evento de configuración al QWaylandXdgSurface correspondiente.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QWaylandXdgPopup::sendPopupDone()

Cerrar la ventana emergente. Según el protocolo xdg-shell, esto debería hacer que el cliente elimine la ventana emergente.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase 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.