Qt WebView
Qt WebView を使えば、QMLアプリケーションの中でウェブコンテンツを表示することができます。完全なウェブブラウザスタックを含むことを避けるため、 は、必要に応じてネイティブAPIを使用します。Qt WebView
これはAndroidや iOSのようなモバイルプラットフォームでは便利です。iOSでは、すべてのウェブコンテンツはオペレーティングシステムのウェブビューを使って表示されるようにポリシーで決められています。
WindowsやLinuxでは、Qt WebView 。 Qt WebEngineモジュールに依存している。
macOSでは、iOSと同じようにシステム・ウェブ・ビューが使用される。
前提条件
QtWebView モジュールをすべてのプラットフォームで正しく機能させるには、Qt モジュールを作成する前に QtWebView::initialize()
インスタンスを作成する前に QGuiApplication
インスタンスを作成する前と、window のQPlatformOpenGLContext
が作成される前に呼び出す必要があります。
モジュールの使用
QML API
モジュールの QML 型はQtWebView
import から利用できます。この型を使用するには、.qml ファイルに以下の import 文を追加してください:
import QtWebView
C++ API
Qt モジュールの C++ API を使用するには、モジュールライブラリを直接リンクするか、他の依存関係を通 してリンクする必要があります。CMakeや qmakeなど、いくつかのビルドツールはこのための専用サポートを持っています。
CMake でのビルド
find_package()
コマンドを使用して、必要なモジュール・コンポーネントをQt6
パッケージから探します:
find_package(Qt6 REQUIRED COMPONENTS WebView)
target_link_libraries(mytarget PRIVATE Qt6::WebView)
詳細については、CMakeによるビルドの概要を参照してください。
qmakeでのビルド
qmakeでビルドするようにモジュールを設定するには、プロジェクトの.proファイルにQT
変数の値としてモジュールを追加します:
QT += webview
制限事項
プラットフォームの制限により、WebView を他の QML コンポーネントとオーバーラップさせることはサポートされていません。他のQMLコンポーネントとオーバーラップさせることはサポートされていません。また、WebView のイベントが Qt のイベントデリバリーシステムに伝搬されることもありません。例えば、特定のイベントを処理するために、WebView の上に不可視のアイテムを "オーバーレイ "したり、WebView が親アイテムで処理しないイベントを処理したりすることはできません。
例
アプリケーションでAPIをどのように使用できるかについては、Qt WebView 「例」をご覧ください。
リファレンス
ライセンス
Qt WebView は、The Qt Company の商用ライセンスで入手できます。さらに、GNU Lesser General Public License, version 3 またはGNU General Public License, version 2 の下でも利用可能です。詳細はQt Licensingを参照してください。
© 2025 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.