En esta página

Tutorial QML 1 - Tipos de valores

Este primer programa es un ejemplo muy simple de "Hola mundo" que introduce algunos conceptos básicos de QML. La imagen de abajo es una captura de pantalla de este programa.

Aquí está el código QML para la aplicación:

import QtQuick

Rectangle {
    id: page
    width: 320; height: 480
    color: "lightgray"

    Text {
        id: helloText
        text: "Hello world!"
        y: 30
        anchors.horizontalCenter: page.horizontalCenter
        font.pointSize: 24; font.bold: true
    }
}

Tutorial

Importar

En primer lugar, tenemos que importar los tipos que necesitamos para este ejemplo. La mayoría de los archivos QML importarán los tipos QML incorporados (como Rectangle, Image, ...) que vienen con Qt, usando:

import QtQuick

Tipo Rectángulo

Rectangle {
    id: page
    width: 320; height: 480
    color: "lightgray"

Declaramos un objeto raíz de tipo Rectangle. Es uno de los bloques básicos que puedes usar para crear una aplicación en QML. Le damos un id para poder referirnos a él más adelante. En este caso, lo llamamos "página". También establecemos las propiedades width, height y color. El tipo Rectangle contiene muchas otras propiedades (como x y y), pero éstas se dejan en sus valores por defecto.

Tipo de texto

    Text {
        id: helloText
        text: "Hello world!"
        y: 30
        anchors.horizontalCenter: page.horizontalCenter
        font.pointSize: 24; font.bold: true
    }

Añadimos un tipo Text como hijo del tipo raíz Rectángulo que muestra el texto "¡Hola mundo!".

La propiedad y se utiliza para posicionar el texto verticalmente a 30 píxeles de la parte superior de su padre.

La propiedad anchors.horizontalCenter se refiere al centro horizontal de un tipo. En este caso, especificamos que nuestro tipo de texto debe estar centrado horizontalmente en el elemento de página (véase Maquetación basada en anclajes).

Las propiedades font.pointSize y font.bold están relacionadas con las fuentes y utilizan la notación de puntos.

Visualización del ejemplo

Para ver lo que ha creado, ejecute la herramienta qml (ubicada en el directorio bin ) con su nombre de archivo como primer argumento. Por ejemplo, para ejecutar el ejemplo Tutorial 1 desde la ubicación de instalación, escriba:

qml tutorials/helloworld/tutorial1.qml

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