Qt Qml

Le module Qt Qml fournit un cadre pour le développement d'applications et de bibliothèques avec le langage QML. Il définit et met en œuvre le langage et l'infrastructure du moteur, et fournit une API permettant aux développeurs d'applications d'enregistrer des types et des modules QML personnalisés et d'intégrer le code QML avec JavaScript et C++. Le module Qt Qml fournit à la fois un QML API et un C++ API.

Utilisation du module

API QML

Les types QML du module sont disponibles via l'importation QtQml. Pour utiliser les types, ajoutez l'instruction d'importation suivante à votre fichier .qml :

import QtQml

Le module Qt Qml contient le cadre QML et les types QML importants utilisés dans les applications. Les constructions de QML sont décrites dans la Référence QML.

Le module QML API du module Qt Qml fournit un certain nombre de types d'objets QML, de types de valeurs QML et d'espaces de noms.

API C

L'utilisation de l'API C++ d'un module Qt nécessite l'établissement d'un lien avec la bibliothèque du module, soit directement, soit par l'intermédiaire d'autres dépendances. Plusieurs outils de construction disposent d'un support dédié à cet effet, notamment CMake et qmake.

L'API C++ contient quelques classes importantes avec lesquelles vous devez vous familiariser. Elle fournit également des types pour contenir des valeurs JavaScript.

Construction avec CMake

Utilisez la commande find_package() pour localiser le composant du module nécessaire dans le paquetage Qt6:

find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)

Pour plus de détails, voir l'aperçu de la construction avec CMake.

Pour fournir un support de type QML étranger à une bibliothèque non-QML, localisez le module QmlIntegration comme suit :

find_package(Qt6 REQUIRED COMPONENTS QmlIntegration)
target_link_libraries(mytarget PRIVATE Qt6::QmlIntegration)

Voir qt6_generate_foreign_qml_types pour plus de détails.

Construction avec qmake

Pour configurer le module afin qu'il soit construit avec qmake, ajoutez le module comme valeur de la variable QT dans le fichier .pro du projet :

QT += qml

Enregistrement des types QML et des modules QML

Afin d'enregistrer des types à utiliser avec QML, vous devez d'abord définir un module QML, de préférence en utilisant qt_add_qml_module dans CMake. Ensuite, vous pouvez ajouter des en-têtes C++ à votre nouveau module, et y définir les types à exposer à QML.

Ajuster le moteur

Il existe un certain nombre de boutons que vous pouvez tourner pour personnaliser le comportement du moteur QML. La page sur la configuration du moteur JavaScript énumère les variables d'environnement que vous pouvez utiliser à cet effet. La description du QML Disk Cache décrit les options liées à la manière dont vos composants QML sont compilés et chargés.

Articles et guides

Ces articles contiennent des informations sur Qt Qml.

• La référence QML
• Qt Qml L'outillage
• Écrire des modules QML
• Singletons en QML

Référence

• C++ Classes
• QML Types

Licences et attributions

Qt Qml est disponible sous licence commerciale auprès de The Qt Company. En outre, il est disponible sous des licences de logiciel libre. Depuis Qt 5.4, ces licences de logiciel libre sont la GNU Lesser General Public License, version 3, ou la GNU General Public License, version 2. Voir Qt Licensing pour plus de détails.

En outre, Qt Qml dans Qt 6.11.0 peut contenir des modules tiers sous les licences permissives suivantes :