Qt Qml

Das Modul „ Qt Qml “ bietet ein Framework für die Entwicklung von Anwendungen und Bibliotheken mit der Sprache QML. Es definiert und implementiert die Sprach- und Engine-Infrastruktur und stellt eine API bereit, die es Anwendungsentwicklern ermöglicht, benutzerdefinierte QML-Typen und -Module zu registrieren sowie QML-Code mit JavaScript und C++ zu integrieren. Das Modul „ Qt Qml “ bietet sowohl eine „ QML API “ als auch eine „ C++ API “.

Verwendung des Moduls

QML-API

Die QML-Typen des Moduls sind über den Import „ QtQml “ verfügbar. Um die Typen zu verwenden, fügen Sie die folgende Importanweisung in Ihre .qml-Datei ein:

import QtQml

Das Modul „ Qt Qml “ enthält das QML-Framework sowie wichtige QML-Typen, die in Anwendungen verwendet werden. Die Konstrukte von QML werden in der „QML-Referenz“ beschrieben.

Die „ QML API “ des Moduls „ Qt Qml “ stellt eine Reihe von QML-Objekttypen, QML-Werttypen und Namespaces bereit.

C++-API

Die Verwendung der C++-API eines Qt-Moduls erfordert die Verknüpfung mit der Modulbibliothek, entweder direkt oder über andere Abhängigkeiten. Mehrere Build-Tools bieten hierfür spezielle Unterstützung, darunter CMake und qmake.

Die C++-API enthält einige wichtige Klassen, mit denen Sie sich vertraut machen sollten. Sie stellt außerdem Typen zur Speicherung von JavaScript-Werten bereit.

Erstellen mit CMake

Verwenden Sie den Befehl „ find_package() “, um die benötigte Modulkomponente im Paket „ Qt6 “ zu finden:

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

Weitere Details finden Sie in der Übersicht „Erstellen mit CMake “.

Um Unterstützung für fremde QML-Typen für eine Nicht-QML-Bibliothek bereitzustellen, suchen Sie das Modul „ QmlIntegration “ wie folgt:

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

Einzelheiten finden Sie unter „qt_generate_foreign_qml_types() “.

Erstellen mit qmake

Um das Modul für den Build mit qmake zu konfigurieren, fügen Sie das Modul als Wert der Variablen „ QT “ in der .pro-Datei des Projekts hinzu:

QT += qml

Registrieren von QML-Typen und QML-Modulen

Um Typen für die Verwendung mit QML zu registrieren, müssen Sie zunächst ein QML-Modul definieren, vorzugsweise mithilfe von `qt_add_qml_module()` in CMake. Anschließend können Sie C++-Header zu Ihrem neuen Modul hinzufügen und darin die Typen definieren, die für QML verfügbar sein sollen.

Anpassung der Engine

Es gibt eine Reihe von Einstellungsmöglichkeiten, mit denen Sie das Verhalten der QML-Engine anpassen können. Auf der Seite zur Konfiguration der JavaScript-Engine sind die Umgebungsvariablen aufgeführt, die Sie zu diesem Zweck verwenden können. Die Beschreibung des QML-Disk-Caches erläutert die Optionen, die sich darauf beziehen, wie Ihre QML-Komponenten kompiliert und geladen werden.

Artikel und Anleitungen

Diese Artikel enthalten Informationen zu „ Qt Qml “.

• Die QML-Referenz
• Qt Qml Werkzeuge
• QML-Module schreiben
• Singletons in QML

Referenz

• C++ Classes
• QML Types

Lizenzen und Urheberangaben

Qt Qml ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter freien Softwarelizenzen verfügbar. Seit Qt 5.4 sind diese freien Softwarelizenzen die GNU Lesser General Public License, Version 3, oder die GNU General Public License, Version 2. Weitere Details finden Sie unter Qt-Lizenzierung.

Darüber hinaus kann „ Qt Qml “ in Qt 6.12.0 Module von Drittanbietern unter den folgenden freizügigen Lizenzen enthalten: