En esta página

Introducción a los controles de « Qt Quick »

A continuación se muestra un ejemplo básico de un archivo QML que utiliza controles:

import QtQuick
import QtQuick.Controls

ApplicationWindow {
    title: "My Application"
    width: 640
    height: 480
    visible: true

    Button {
        text: "Push Me"
        anchors.centerIn: parent
    }
}

Configuración de controles desde C++

Aunque tradicionalmente se ha utilizado « QQuickView » para mostrar archivos QML en una aplicación de C++, esto implica que solo se pueden configurar las propiedades de la ventana desde C++.

Con los controles de Qt Quick, declara un ` ApplicationWindow ` como elemento raíz de tu aplicación y ejecútalo utilizando ` QQmlApplicationEngine ` en su lugar. Esto garantiza que puedas controlar las propiedades de la ventana de nivel superior desde QML.

A continuación se muestra un ejemplo básico de un archivo fuente que utiliza controles:

#include <QGuiApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Uso de datos de C++ desde QML

Si necesitas registrar una clase de C++ para utilizarla desde QML, puedes llamar a ` qmlRegisterType()` antes de declarar tu ` QQmlApplicationEngine`. Consulta «Definición de tipos QML desde C++» para obtener más información.

Si necesitas exponer datos a los componentes QML, debes hacer que estén disponibles en el contexto del motor QML actual. Consulta « QQmlContext » para obtener más información.

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