Overlay QML Type
Una superposición de ventana para ventanas emergentes. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades asociadas
Señales adjuntas
Descripción detallada
La superposición proporciona una capa para las ventanas emergentes, lo que garantiza que estas se muestren por encima del resto del contenido y que el fondo se atenúe cuando una ventana emergente de modal o dimmed esté visible.
La superposición es un elemento normal que cubre toda la ventana. Se puede utilizar como elemento padre visual para colocar una ventana emergente en las coordenadas de la escena.
El siguiente ejemplo utiliza la propiedad Overlay.overlay adjunta para situar una ventana emergente en el centro de la ventana, independientemente de la posición del botón que la abre:
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 propiedades adjuntas
Overlay.modal : Component [attached]
Esta propiedad adjunta contiene un componente que se utiliza como elemento visual y que permite atenuar el fondo de las ventanas emergentes modales. Se crea para las ventanas emergentes modales visibles y se coloca debajo de ellas.
La propiedad se puede asociar a cualquier ventana emergente.
Por ejemplo, para cambiar el color del atenuado del 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 [attached]
Esta propiedad adjunta contiene un componente que se utiliza como elemento visual y que permite atenuar el fondo de las ventanas emergentes no modales. Se crea para las ventanas emergentes con atenuación visible y se coloca debajo de ellas.
La propiedad se puede asociar a cualquier ventana emergente.
Por ejemplo, para cambiar el color del oscurecimiento del fondo de una ventana emergente no modal, 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 attached]
Esta propiedad asociada contiene el elemento de superposición de la ventana.
La propiedad se puede asociar a cualquier elemento, ventana emergente o ventana. Cuando se asocia a un elemento o a una ventana emergente, el valor es « null » si el elemento o la ventana emergente no se encuentran dentro de una ventana.
Documentación sobre la señal «Attached»
[attached] pressed()
Esta señal adjunta se emite cuando el usuario pulsa sobre la superposición mientras hay una ventana emergente visible.
La señal se puede asociar a cualquier elemento, ventana emergente o ventana. Cuando se asocia a un elemento o a una ventana emergente, la señal solo se emite si el elemento o la ventana emergente se encuentran dentro de una ventana.
Nota: A partir de Qt 6.9, esta señal no se emite al hacer clic con el botón derecho. En su lugar, utiliza un ` TapHandler ` asociado a la superposición.
Nota: El controlador correspondiente es ` onPressed`.
[attached] released()
Esta señal adjunta se emite cuando el usuario suelta la superposición mientras hay una ventana emergente visible.
La señal se puede asociar a cualquier elemento, ventana emergente o ventana. Cuando se asocia a un elemento o a una ventana emergente, la señal solo se emite si el elemento o la ventana emergente se encuentran dentro de una ventana.
Nota: A partir de Qt 6.9, esta señal no se emite al hacer clic con el botón derecho. En su lugar, utiliza un ` TapHandler ` asociado a la superposición.
Nota: El controlador 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.