En esta página

Primeros pasos con Qt Quick Controls

Aquí se muestra un ejemplo básico de un archivo QML que hace uso de 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 QQuickView se ha utilizado tradicionalmente para mostrar archivos QML en una aplicación C++, hacer esto significa que sólo se pueden configurar las propiedades de la ventana desde C++.

Con Qt Quick Controls, declare un ApplicationWindow como elemento raíz de su aplicación y láncelo utilizando QQmlApplicationEngine en su lugar. Esto garantiza que pueda controlar las propiedades de ventana de nivel superior desde QML.

A continuación se muestra un ejemplo básico de un archivo fuente que hace uso de 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 C++ desde QML

Si necesita registrar una clase C++ para utilizarla desde QML, puede llamar a qmlRegisterType() antes de declarar su QQmlApplicationEngine. Consulte Definición de tipos QML desde C++ para obtener más información.

Si necesita exponer datos a componentes QML, debe ponerlos a disposición del contexto del motor QML actual. Consulte 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.