Routine d'interface utilisateur Qt Declarative

Les documents QML sont chargés et exécutés par la routine QML. Elle inclut le moteur de l'interface utilisateur Declarative ainsi que les éléments intégrés au QML et les plug-ins. Elle fournit aussi un accès aux éléments QML tiers et aux modules.

Les applications qui utilisent le QML ont besoin d'invoquer la routine QML afin d'exécuter les documents QML. Cela peut être fait en créant un QDeclarativeView ou un QDeclarativeEngine, comme décrit ci-dessous. De plus, le paquet de l'interface utilisateur Declarative inclut l'outil Qt QML Viewer, permettant de charger des fichiers .qml. Cet outil est pratique pour développer et tester du code QML sans avoir à écrire une application C++ pour charger la routine QML.

Déploiement d'applications basées sur QML

Pour déployer une application qui utilise QML, la routine QML doit être invoquée par l'application. Cela est effectué en écrivant une application C++ Qt qui charge le QDeclarativeEngine soit :

• en chargeant le fichier QML grâce à une instance de QDeclarativeView ;
• en créant une instance de QDeclarativeEngine et en chargeant les fichiers QML avec QDeclarativeComponent.

Déploiement avec QDeclarativeView

QDeclarativeView est une classe basée sur QWidget qui peut charger des fichiers QML. Par exemple, s'il y a un fichier QML, application.qml, comme celui-ci :

 import QtQuick 1.0
 
 Rectangle { width: 100; height: 100; color: "red" }

Il peut être chargé dans une application Qt, à l'aide du fichier main.cpp suivant :

 #include <QApplication>
 #include <QDeclarativeView>
 
 int main(int argc, char *argv[])
 {
     QApplication app(argc, argv);
 
     QDeclarativeView view;
     view.setSource(QUrl::fromLocalFile("application.qml"));
     view.show();
 
     return app.exec();
 }

Cela crée une vue basée sur QWidget qui affiche le contenu de application.qml.

Le fichier de projet .pro de l'application doit spécifier le module declarative dans la variable QT. Par exemple :

 TEMPLATE += app
 QT += gui declarative
 SOURCES += main.cpp

Créer un QDeclarativeEngine directement

Si le fichier application.qml n'a aucun composant graphique ou s'il est préférable d'éviter QDeclarativeView pour d'autres raisons, le QDeclarativeEngine peut être construit directement. Dans ce cas, application.qml est chargé dans une instance de QDeclarativeComponent au lieu d'être placé dans une vue :

 #include <QApplication>
 #include <QDeclarativeEngine>
 #include <QDeclarativeContext>
 #include <QDeclarativeComponent>
 
 int main(int argc, char *argv[])
 {
     QApplication app(argc, argv);
 
     QDeclarativeEngine engine;
     QDeclarativeContext *objectContext = new QDeclarativeContext(engine.rootContext());
 
     QDeclarativeComponent component(&engine, "application.qml");
     QObject *object = component.create(objectContext);
 
     // ... détruit objet et objectContext lorsque nécessaire
 
     return app.exec();
 }

Voir comment utiliser QML dans les applications C++ pour plus d'informations sur l'utilisation de QDeclarativeEngine, QDeclarativeContext et QDeclarativeComponent, et sur l'inclusion de fichier QML avec le système de ressources Qt.

Développer et conception de prototype avec le ''QML Viewer''

Le paquet d'interface utilisateur Declarative inclut un outil pour la routine QML, le Qt QML Viewer, permettant de charger et d'afficher les documents QML. Cela est utile lors de la phase de développement de l'application pour concevoir des prototypes d'applications basées sur QML sans écrire vos propres applications C++ afin de lancer la routine QML.

Voir la documentation de QML Viewer pour plus de détails.

Remerciements

Merci à Alexandre Laurent pour la traduction ainsi qu'à Dimitry Ernot, Jonathan Courtois et Claude Leloup pour leur relecture !