Qt Qml 設計サポート
Qt Qml の「Design Support」モジュールは、QML内でオブジェクトを登録および参照するための一連の型を提供し、デザインツールをサポートします。オブジェクトは登録時にキー文字列で識別され、参照型はこのキーを使用して登録されたオブジェクトへの参照を取得できます。 この仕組みの目的は、特に何らかのツールによって UI コードが自動生成され、開発者が手動でそれを変更することが想定されていない場合において、UI コードとビジネスロジックを明確に分離できるようにすることです。Qt Qml の「デザインサポート」モジュールは、登録されたオブジェクトを参照するためのQML APIとC++ APIの両方を提供します。オブジェクトの登録機能は、QML API でのみ利用可能です。
Qt Qml デザインサポートモジュールは、Qt 6.12で導入されました。
モジュールの使用方法
QML API
このモジュールのQML型は、QtQml.DesignSupport インポートを通じて利用できます。これらの型を使用するには、.qmlファイルに次のインポート文を追加してください。
import QtQml.DesignSupportQt Qml Design Support モジュールのQML APIは、QML オブジェクトの登録および登録済み QML オブジェクトへの参照に必要な型を提供します。
C++ API
QtモジュールのC++ APIを使用するには、モジュールライブラリに対して、直接または他の依存関係を通じてリンクを行う必要があります。CMakeやqmakeなど、いくつかのビルドツールにはこのための専用のサポートが用意されています。
Qt Qml Design Support モジュールのC++ APIは、登録済みの QML オブジェクトを参照するために必要なクラスを提供します。
CMake を使用したビルド
`find_package() ` コマンドを使用して、Qt6 パッケージ内の必要なモジュールコンポーネントを指定します。
find_package(Qt6 REQUIRED COMPONENTS QmlDesignSupport)
target_link_libraries(mytarget PRIVATE Qt6::QmlDesignSupport)詳細については、「CMake を使用したビルド」の概要を参照してください。
qmake を使用したビルド
qmake を使用してビルドするようにモジュールを設定するには、プロジェクトの .pro ファイル内で、QT 変数の値としてそのモジュールを追加します:
QT += qmldesignsupportAPIリファレンス
ライセンスおよび帰属表示
Qt Qml Design Supportは、The Qt Companyから商用ライセンスの下で提供されています。また、GNU Lesser General Public License(バージョン3) またはGNU General Public License(バージョン2)の下でも利用可能です。詳細については、「Qtのライセンス」を参照してください。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.