Overlay QML Type
Una ventana superpuesta para ventanas emergentes. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades adjuntas
Señales adjuntas
Descripción detallada
La superposición proporciona una capa para las ventanas emergentes, garantizando que éstas se muestren por encima de otros contenidos y que el fondo se atenúe cuando una ventana emergente modal o dimmed esté visible.
La superposición es un elemento ordinario que cubre toda la ventana. Puede utilizarse como padre visual para posicionar una ventana emergente en coordenadas de escena.
El siguiente ejemplo utiliza la propiedad adjunta Overlay.overlay para posicionar un popup en el centro de la ventana, a pesar de la posición del botón que abre el popup:
Button { onClicked: popup.open() Popup { id: popup parent: Overlay.overlay x: Math.round((parent.width - width) / 2) y: Math.round((parent.height - height) / 2) width: 100 height: 100 } }
Véase también ApplicationWindow.
Documentación de la propiedad Attached
Overlay.modal : Component
Esta propiedad adjunta contiene un componente para utilizar como elemento visual que implementa la atenuación de fondo para las ventanas emergentes modales. Se crea para y se apila debajo de las ventanas emergentes visibles.
La propiedad puede adjuntarse a cualquier ventana emergente.
Por ejemplo, para cambiar el color de la atenuación de fondo de una ventana emergente modal, se puede utilizar el siguiente código:
Popup { id: popup width: 400 height: 400 modal: true visible: true Overlay.modal: Rectangle { color: "#aacfdbe7" } }
Véase también Popup::modal.
Overlay.modeless : Component
Esta propiedad adjunta contiene un componente para utilizar como elemento visual que implementa la atenuación de fondo para ventanas emergentes sin modelo. Se crea para y se apila debajo de las ventanas emergentes de oscurecimiento visibles.
La propiedad puede adjuntarse a cualquier ventana emergente.
Por ejemplo, para cambiar el color de la atenuación de fondo de una ventana emergente sin modelo, se puede utilizar el siguiente código:
Popup { id: popup width: 400 height: 400 dim: true visible: true Overlay.modeless: Rectangle { color: "#aacfdbe7" } }
Véase también Popup::dim.
Overlay.overlay : Overlay [read-only]
Esta propiedad adjunta contiene el elemento superpuesto de la ventana.
La propiedad puede adjuntarse a cualquier elemento, ventana emergente o ventana. Cuando se adjunta a un ítem o a un popup, el valor es null si el ítem o popup no está en una ventana.
Documentación de la señal adjunta
pressed()
Esta señal adjunta se emite cuando el usuario pulsa la superposición mientras una ventana emergente está visible.
La señal puede adjuntarse a cualquier elemento, ventana emergente o ventana. Cuando se adjunta a un elemento o a una ventana emergente, la señal sólo se emite si el elemento o la ventana emergente se encuentra en una ventana.
Nota: A partir de Qt 6.9, esta señal no se emite para los clics con el botón derecho. En su lugar, utilice un TapHandler vinculado a la superposición.
Nota: El manejador correspondiente es onPressed.
released()
Esta señal adjunta se emite cuando el usuario suelta la superposición mientras una ventana emergente está visible.
La señal puede adjuntarse a cualquier elemento, ventana emergente o ventana. Cuando se adjunta a un elemento o ventana emergente, la señal sólo se emite si el elemento o ventana emergente está en una ventana.
Nota: A partir de Qt 6.9, esta señal no se emite para los clics con el botón derecho. En su lugar, utilice un TapHandler vinculado a la superposición.
Nota: El manejador correspondiente es onReleased.
© 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.
