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 implémente le langage ainsi que l’infrastructure du moteur, et fournit une API permettant aux développeurs d’applications d’enregistrer des types et des modules QML personnalisés, ainsi que d’intégrer du code QML à du JavaScript et du C++. Le module « Qt Qml » fournit à la fois une interface « QML API » et une interface « C++ API ».

Utilisation du module

API QML

Les types QML du module sont disponibles via l’importation QtQml. Pour utiliser ces types, ajoutez la déclaration d’importation suivante à votre fichier .qml :

import QtQml

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

L’ 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 une liaison avec la bibliothèque du module, soit directement, soit via d'autres dépendances. Plusieurs outils de compilation prennent cela en charge, notamment CMake et qmake.

L’API C++ contient certaines classes importantes que vous devriez vous familiariser. Elle fournit également des types permettant de stocker des valeurs JavaScript.

Compilation avec CMake

Utilisez la commande « find_package() » pour localiser le composant de module requis dans le paquet « Qt6 » :

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

Pour plus de détails, consultez la présentation « Compilation avec CMake ».

Pour prendre en charge des types QML externes dans 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 qt_generate_foreign_qml_types() pour plus de détails.

Compilation avec qmake

Pour configurer le module en vue d’une compilation avec qmake, ajoutez le module en tant que 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 destinés à être utilisés avec QML, vous devez d’abord définir un module QML, de préférence à l’aide de la fonction qt_add_qml_module() dans CMake. Vous pouvez ensuite ajouter des en-têtes C++ à votre nouveau module et y définir les types à exposer à QML.

Réglage du moteur

Il existe plusieurs paramètres que vous pouvez ajuster pour personnaliser le comportement du moteur QML. La page consacrée à la configuration du moteur JavaScript répertorie les variables d’environnement que vous pouvez utiliser à cette fin. La description du cache disque QML détaille les options relatives à 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 Outils
• Écriture de modules QML
• Les singletons en QML

Référence

• C++ Classes
• QML Types

Licences et mentions légales

Qt Qml est disponible sous licence commerciale auprès de The Qt Company. Il est également disponible sous licence de logiciel libre. Depuis Qt 5.4, ces licences de logiciel libre sont la Licence publique générale réduite GNU, version 3, ou la Licence publique générale GNU, version 2. Voir Licences Qt pour plus de détails.

Par ailleurs, l'Qt Qml, dans Qt 6.12.0, peut contenir des modules tiers sous les licences permissives suivantes :