En esta página

Tutorial de QML 1: Tipos de valor

Este primer programa es un ejemplo muy sencillo de «Hola mundo» que presenta algunos conceptos básicos de QML. La imagen que aparece a continuación es una captura de pantalla de este programa.

«¡Hola, mundo!» en letra negra sobre fondo gris

Este es el código QML de 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
    }
}

Guía paso a paso

Importación

En primer lugar, debemos importar los tipos que necesitamos para este ejemplo. La mayoría de los archivos QML importan los tipos QML integrados (como Rectangle, Image, etc.) que vienen con Qt, utilizando:

import QtQuick

Tipo Rectangle

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

Declaramos un objeto raíz de tipo ` Rectangle`. Es uno de los componentes básicos que puedes utilizar para crear una aplicación en QML. Le asignamos un ` id ` para poder hacer referencia a él más adelante. En este caso, lo llamamos «page». También configuramos las propiedades width, height y color. El tipo Rectangle contiene muchas otras propiedades (como x y y), pero estas se dejan con sus valores por defecto.

Tipo «Text»

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

Añadimos un tipo « Text » como elemento hijo del tipo «Rectangle» raíz que muestra el texto «Hello world!».

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

La propiedad ` anchors.horizontalCenter ` hace referencia al centro horizontal de un elemento de tipo `text`. En este caso, especificamos que nuestro elemento de tipo `text` debe estar centrado horizontalmente en el elemento de página (véase «Diseño basado 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 has creado, ejecuta la herramienta qml (situada en el directorio bin ) con el nombre de tu archivo como primer argumento. Por ejemplo, para ejecutar el ejemplo completo del Tutorial 1 que se proporciona desde la ubicación de instalación, escribirías:

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.