Qt Qml

Qt Qml モジュールは、QML言語を用いたアプリケーションやライブラリの開発のためのフレームワークを提供します。このモジュールは、言語およびエンジンの基盤を定義・実装するとともに、アプリケーション開発者がカスタムQML型やモジュールを登録し、QMLコードをJavaScriptやC++と統合できるようにするAPIを提供します。Qt Qml モジュールは、QML API とC++ API の両方を提供します。

モジュールの使用方法

QML API

このモジュールのQML型は、QtQml のインポートを通じて利用可能です。これらの型を使用するには、.qmlファイルに次のインポート文を追加してください：

import QtQml

Qt Qml モジュールには、QMLフレームワークおよびアプリケーションで使用される重要なQML型が含まれています。QMLの構文については、『The QML Reference』で説明されています。

Qt Qml モジュールのQML API は、多数のQMLオブジェクト型、QML値型、および名前空間を提供します。

C++ API

QtモジュールのC++ APIを使用するには、直接、あるいは他の依存関係を通じて、モジュールライブラリに対してリンクを行う必要があります。CMakeやqmakeなど、いくつかのビルドツールでは、これに対する専用のサポートが提供されています。

C++ API には、理解しておくべき重要なクラスがいくつか含まれています。また、JavaScript 値を保持するための型も提供しています。

CMake を使用したビルド

find_package() コマンドを使用して、Qt6 パッケージ内の必要なモジュールコンポーネントを特定します。

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

詳細については、「CMake によるビルド」の概要を参照してください。

QML以外のライブラリに対して外部QML型のサポートを提供するには、次のようにQmlIntegration モジュールを指定します：

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

詳細については、qt_generate_foreign_qml_types()を参照してください。

qmake を使用したビルド

qmake を使用してビルドするようにモジュールを設定するには、プロジェクトの .pro ファイル内で、QT 変数の値としてそのモジュールを追加します:

QT += qml

QML タイプおよび QML モジュールの登録

QMLで使用するために型を登録するには、まずQMLモジュールを定義する必要があります。できれば、CMakeのqt_add_qml_module()を使用してください。その後、新しいモジュールにC++ヘッダーを追加し、その中でQMLに公開する 型を定義できます。

エンジンの調整

QMLエンジンの動作をカスタマイズするために調整できる設定項目がいくつかあります。JavaScriptエンジンの設定に関するページには、この目的で使用できる環境変数が一覧されています。QMLディスクキャッシュの説明には、QMLコンポーネントのコンパイルおよび読み込み方法に関連するオプションが記載されています。

記事とガイド

以下の記事には、Qt Qml に関する情報が記載されています。

• QMLリファレンス
• Qt Qml ツール
• QMLモジュールの作成
• QML におけるシングルトン

リファレンス

• C++ Classes
• QML Types

ライセンスおよび帰属表示

Qt Qml は、The Qt Company からの商用ライセンスの下で提供されています。さらに、フリーソフトウェアライセンスの下でも利用可能です。Qt 5.4 以降、これらのフリーソフトウェアライセンスはGNU Lesser General Public License バージョン 3 またはGNU General Public License バージョン 2 です。詳細については、「Qt ライセンス」を参照してください。

さらに、Qt 6.12.0のQt Qml には、以下の寛容なライセンスに基づくサードパーティ製モジュールが含まれている場合があります：