QQuickWidget - QQuickViewの比較例
ネイティブ・ウィンドウとして埋め込まれたQQuickView に対するQQuickWidget の利点を示します。

この例では、2つの異なるアプローチを使用して、同じQWidget-ベースのユーザーインターフェイス内で同じQt Quick シーンを表示することができます:
- QQuickView を使用。
子ウィンドウとして使用し、QWidget::createWindowContainer()
- QQuickWidget を使用する。
真のQWidget として動作し、特に、真のQWidget から期待されるように、より優れたクリッピングとスタッキングをサポートします。
Show widget overlay QQuickWidget チェックボックスをクリックすると、ネイティブウィンドウを埋め込んだときに期待通りにレンダリングされないウィジェットのスタッキングケースが示されます。
例の実行
からサンプルを実行するには Qt Creatorからサンプルを実行するには、Welcome モードを開き、Examples からサンプルを選択します。詳細については、Qt Creator:チュートリアルを参照してください:ビルドと実行を参照してください。
プラットフォームに関する注意事項
Qt Quick のシーンは、QQuickWidget で埋め込まれた場合でも、直接 OpenGL レンダリングを使用します。これは、レンダリングが引き続きアクセラレーテッド3D APIを使用していることを確認しています。
したがって、この例はOpenGLに縛られており、Vulkan、Metal、Direct3Dなどの他のグラフィックスAPIでは動作しません。
マルチサンプル・アンチエイリアス
対応するチェックボックスを選択することで、マルチサンプル・アンチエイリアシングを有効にできます。有効にすると、QQuickWidget 、コンテンツがマルチサンプルレンダバッファにレンダリングされます。各レンダー パスの後、コンテンツは標準の 2D テクスチャに分解されます。これにより、QWidget ベースの UI の残りの部分に影響を与えることなく、Qt Quick コンテンツのアンチエイリアシングが有効になります。
QQuickView を使用している場合、ネイティブウィンドウはそのサーフェスにマルチサンプリングを要求します。これは、プラットフォームのサポートにもよりますが、同様の結果をもたらします。
キーボード入力
Qt Quick シーンは、使用されるエンベッディング・テクノロジーに関係なく、テキスト入力を含むユーザー・インタラクションをサポートします。QQuickWidget を使用する場合、入力イベントは自動的にQt Quick シーンに転送されます。
Qt Quick ウィジェットも参照してください 。
© 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.