Qt Quick Ejemplos: Ventana y Pantalla
Este ejemplo muestra los tipos «Window» y «Screen» en QML.

«Ventana» y «Pantalla » muestran cómo:
- crear una ventana en QML
- controlar su visibility
- mostrar una pantalla de inicio al iniciar la aplicación
- acceder a las propiedades de la Screen
También muestra cómo empaquetar QML en recursos y proporcionar un icono para crear una aplicación de escritorio QML independiente.
Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Implementación de la ventana
Se puede crear una pantalla de inicio con el indicador ` Qt.SplashScreen `, y debe estar ` ApplicationModal ` para impedir la interacción con la ventana principal. Si la ventana de inicio también es transparente y muestra una imagen parcialmente transparente, tendrá el aspecto de una ventana con forma.
Window {
id: splash
color: "transparent"
title: "Splash Window"
modality: Qt.ApplicationModal
flags: Qt.SplashScreen
property int timeoutInterval: 2000
signal timeoutEn este ejemplo, « Timer » ocultará automáticamente la pantalla de inicio, pero en una aplicación real es posible que quieras conectarte a una señal de la lógica de la aplicación para ocultar la pantalla de inicio cuando finalice la inicialización.
Timer {
interval: splash.timeoutInterval; running: splash.visible; repeat: false
onTriggered: splash.exit()
}La ventana principal de este ejemplo es la ventana de control, con algunos botones y casillas de selección para controlar y proporcionar información sobre el estado de una ventana secundaria. Cada casilla de selección tiene un enlace a la propiedad cuyo estado muestra, así como un controlador onClicked para cambiar dicho estado. Este es el patrón típico para crear un enlace bidireccional evitando los bucles de enlace.
CheckBox {
text: "Windowed"
height: showButton.height
width: col.cellWidth
Binding on checked { value: root.testWindow.visibility === Window.Windowed }
onClicked: root.testWindow.visibility = Window.Windowed
}Screen tiene varias propiedades que suelen resultar útiles para aplicaciones que necesitan rotar algún contenido cuando cambia la orientación de la pantalla, para colocar ventanas en la pantalla o para convertir unidades reales en unidades lógicas de píxeles. CurrentScreen.qml (que se muestra en línea en window.qml, o que se puede ejecutar por sí solo con la herramienta qml) simplemente muestra los valores de las propiedades, mientras que la pantalla de inicio los utiliza para centrar la ventana en la pantalla.
x: (Screen.width - splashImage.width) / 2
y: (Screen.height - splashImage.height) / 2Si una ventana « Window » está anidada dentro de una « Item » u otra ventana, la ventana interna se convierte en transitoria para la externa (véase Window para obtener más explicaciones). Pero si quieres crear varias ventanas de nivel superior como pares independientes, puedes crearlas dentro de un elemento raíz « QtObject » no visual, tal y como se muestra en este ejemplo.
© 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.