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.

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