En esta página

XdgPopup QML Type

XdgPopup representa las partes específicas de una ventana emergente de una superficie xdg. Más información...

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgPopup

Propiedades

Métodos

Descripción detallada

Este tipo forma parte de la extensión XdgShell y ofrece una forma de ampliar la funcionalidad de un XdgSurface 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

anchorEdges : enumeration [read-only]

Esta propiedad contiene el conjunto de bordes del rectángulo de anclaje respecto al cual debe colocarse la superficie secundaria. Si no se especifican bordes en una dirección, el punto de anclaje debe situarse en el centro entre los bordes.

Los valores posibles son:

ConstanteDescripción
Qt.TopEdgeEl borde superior del rectángulo.
Qt.LeftEdgeEl borde izquierdo del rectángulo.
Qt.RightEdgeEl borde derecho del rectángulo.
Qt.BottomEdgeEl borde inferior del rectángulo.

anchorRect : rect [read-only]

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

configuredGeometry : rect [read-only]

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.

flipConstraints : enumeration [read-only]

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

Valores posibles:

ConstanteDescripción
Qt.HorizontalHorizontal
Qt.VerticalVertical

gravityEdges : rect [read-only]

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

Los valores posibles son:

ConstanteDescripción
Qt.TopEdgeLa superficie debe deslizarse hacia la parte superior de la pantalla.
Qt.LeftEdgeLa superficie debe deslizarse hacia la izquierda de la pantalla.
Qt.RightEdgeLa superficie debe deslizarse hacia la derecha de la pantalla.
Qt.BottomEdgeLa superficie debe deslizarse hacia la parte inferior de la pantalla.

offset : point [read-only]

La posición en relación con la posición del anclaje en el rectángulo de anclaje y la del anclaje en la superficie.

parentXdgSurface : XdgSurface [read-only]

Esta propiedad contiene el objeto ` XdgSurface ` asociado al elemento padre de este ` XdgPopup`.

positionerSize : size [read-only]

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

resizeConstraints : enumeration [read-only]

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

Valores posibles:

ConstanteDescripción
Qt.HorizontalHorizontal
Qt.VerticalVertical

slideConstraints : enumeration [read-only]

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

Valores posibles:

ConstanteDescripción
Qt.HorizontalHorizontal
Qt.VerticalVertical

unconstrainedPosition : point [read-only]

La posición de la superficie con 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.

xdgSurface : XdgSurface [read-only]

Esta propiedad contiene el objeto ` XdgSurface ` asociado a este ` XdgPopup`.

Documentación del método

int sendConfigure(rect 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 envía implícitamente un evento de configuración también a la XdgSurface correspondiente.

void sendPopupDone()

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

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