En esta página

Qt Quick Ejemplos: Ventana y Pantalla

Este ejemplo muestra los tipos «Window» y «Screen» en QML.

Ventana de control con botones de visibilidad y propiedades de pantalla, junto con una ventana de prueba secundaria

«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:

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 timeout

En 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) / 2

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

Proyecto de ejemplo en @ code.qt.io

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