Tutorial avanzado de QML 1: Creación del lienzo del juego y los bloques
Creación de la pantalla de la aplicación
El primer paso consiste en crear los elementos básicos de QML en tu aplicación.
Para empezar, creamos nuestra aplicación «Same Game» con una pantalla principal como esta:

Esto viene definido por el archivo principal de la aplicación, « samegame.qml », que tiene este aspecto:
import QtQuick
Rectangle {
id: screen
width: 490; height: 720
SystemPalette { id: activePalette }
Item {
width: parent.width
anchors { top: parent.top; bottom: toolBar.top }
Image {
id: background
anchors.fill: parent
source: "pics/background.jpg"
fillMode: Image.PreserveAspectCrop
}
}
Rectangle {
id: toolBar
width: parent.width; height: 30
color: activePalette.window
anchors.bottom: screen.bottom
Button {
anchors { left: parent.left; verticalCenter: parent.verticalCenter }
text: "New Game"
onClicked: console.log("This doesn't do anything yet...")
}
Text {
id: score
anchors { right: parent.right; verticalCenter: parent.verticalCenter }
text: "Score: Who knows?"
}
}
}Esto te proporciona una ventana de juego básica que incluye el lienzo principal para los bloques, un botón «New Game» y un indicador de puntuación.
Un elemento que quizá no reconozcas aquí es el SystemPalette. Este proporciona acceso a la paleta del sistema Qt y se utiliza para dar al botón un aspecto más nativo.
Fíjate en que los anclajes para los tipos Item, Button y Text se definen utilizando la notación de grupo (punto) para facilitar la legibilidad.
Añadir los componentes ` Button ` y ` Block `
El elemento « Button » del código anterior se define en un archivo de componentes independiente denominado « Button.qml ». Para crear un botón funcional, utilizamos los tipos QML « Text » y « MouseArea » dentro de un « Rectangle ». A continuación se muestra el código de « Button.qml »:
import QtQuick
Rectangle {
id: container
property string text: "Button"
signal clicked
width: buttonLabel.width + 20; height: buttonLabel.height + 5
border { width: 1; color: Qt.darker(activePalette.button) }
antialiasing: true
radius: 8
// color the button with a gradient
gradient: Gradient {
GradientStop {
position: 0.0
color: {
if (mouseArea.pressed)
return activePalette.dark
else
return activePalette.light
}
}
GradientStop { position: 1.0; color: activePalette.button }
}
MouseArea {
id: mouseArea
anchors.fill: parent
onClicked: container.clicked();
}
Text {
id: buttonLabel
anchors.centerIn: container
color: activePalette.buttonText
text: container.text
}
}Esto define, básicamente, un rectángulo que contiene texto y sobre el que se puede hacer clic. El MouseArea tiene un controlador onClicked() que está implementado para emitir la señal clicked() del container cuando se hace clic en el área.
En Same Game, la pantalla se llena de pequeños bloques cuando comienza el juego. Cada bloque es simplemente un elemento que contiene una imagen. El código del bloque se define en un archivo Block.qml independiente:
import QtQuick
Item {
id: block
Image {
id: img
anchors.fill: parent
source: "pics/redStone.png"
}
}Por el momento, el bloque no hace nada; es simplemente una imagen. A medida que avance el tutorial, animaremos los bloques y les daremos comportamientos. Todavía no hemos añadido ningún código para crear los bloques; lo haremos en el siguiente capítulo.
Hemos configurado la imagen para que tenga el mismo tamaño que su elemento padre mediante ` anchors.fill: parent`. Esto significa que, cuando más adelante en el tutorial creemos y redimensionemos dinámicamente los elementos del bloque, la imagen se escalará automáticamente al tamaño correcto.
Fíjate en la ruta relativa de la propiedad ` source ` del tipo `Image`. Esta ruta es relativa a la ubicación del archivo que contiene el tipo ` Image `. Como alternativa, podrías establecer la fuente de la imagen en una ruta de archivo absoluta o en una URL que contenga una imagen.
A estas alturas, ya deberías estar familiarizado con el código. Acabamos de crear algunos tipos básicos para empezar. A continuación, llenaremos el lienzo del juego con algunos bloques.
© 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.