Qt Quick ウィジェット

Qt Quick ウィジェットモジュールは、QQuickWindow の利便性を高めるラッパーです。メインのqml ファイルのURLを指定すると、QMLシーンを自動的に読み込んで表示します。あるいは、QQmlComponent を使用してQMLオブジェクトをインスタンス化し、手動で設定したQQuickWidget に配置することも可能です。

一般的な使用方法：

QQuickWidget *view = new QQuickWidget;
view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
view->show();

QQuickWidget また、ビューとルートアイテムのサイズ変更も管理します。デフォルトでは、resizeMode はSizeViewToRootObject に設定されており、これによりコンポーネントが読み込まれ、ビューに収まるようにサイズが調整されます。あるいは、resizeMode をSizeViewToRootObject に設定することも可能です。これにより、ビューがルートアイテムに合わせてサイズ変更されます。

モジュールの使用

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

CMake を使用したビルド

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

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

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

qmake を使用したビルド quickwidgets

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

QT += quickwidgets

参照

• Qt Quick Widgets C++ Classes

例

• Qt Quick ウィジェットの例
• QQuickWidget と QQuickView の比較例
• QML プレビューアーの例

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

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