En esta página

XdgPopup QML Type

XdgPopup representa las partes específicas emergentes de una superficie xdg. Más...

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 proporciona 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 aristas del rectángulo de anclaje con respecto a las cuales debe colocarse la superficie secundaria. Si no se especifica ninguna arista en una dirección, el punto de anclaje debe centrarse entre las aristas.

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 relativo a la geometría de la ventana padre con respecto al cual debe colocarse la superficie hija.

configuredGeometry : rect [read-only]

La geometría de la ventana emergente recibida en el evento configure. Relativa a la esquina superior izquierda de la superficie padre.

flipConstraints : enumeration [read-only]

Esta propiedad contiene las orientaciones en las que el niño debe voltearse para encajar en la pantalla.

Valores posibles:

ConstanteDescripción
Qt.HorizontalHorizontal
Qt.VerticalVertical

gravityEdges : rect [read-only]

Especifica en qué dirección debe posicionarse 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 relativa a la posición del ancla en el rectángulo de anclaje y del ancla en la superficie.

parentXdgSurface : XdgSurface [read-only]

Esta propiedad contiene el XdgSurface asociado con el 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 contiene las orientaciones en las que el niño debe cambiar de tamaño para encajar en la pantalla.

Valores posibles:

ConstanteDescripción
Qt.HorizontalHorizontal
Qt.VerticalVertical

slideConstraints : enumeration [read-only]

Esta propiedad contiene las orientaciones en las que el niño debe deslizarse para encajar en la pantalla.

Valores posibles:

ConstanteDescripción
Qt.HorizontalHorizontal
Qt.VerticalVertical

unconstrainedPosition : point [read-only]

La posición de la superficie relativa a la geometría de la ventana padre si la superficie no está restringida. Es decir, cuando no se mueve para ajustarse al interior de la pantalla o similar.

xdgSurface : XdgSurface [read-only]

Esta propiedad contiene el XdgSurface asociado con este XdgPopup.

Documentación del método

int sendConfigure(rect geometry)

Envía un evento configure al cliente. geometry contiene la geometría de la ventana relativa a la esquina superior izquierda de la geometría de la ventana de la superficie padre.

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

void sendPopupDone()

Rechaza la ventana emergente. Según el protocolo xdg-shell esto debería hacer que el cliente destruya 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.