En esta página

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:

Lienzo de juego vacío con el botón «Nueva partida» y un marcador provisional

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.

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.