Qt WebView

Qt WebView を使えば、QMLアプリケーションの中でWebコンテンツを表示することができます。完全なウェブブラウザスタックを含むことを避けるため、Qt WebView は、必要に応じてネイティブAPIを使用します。

これはAndroidや iOSのようなモバイルプラットフォームでは便利です。iOSの場合、すべてのウェブコンテンツはオペレーティングシステムのウェブビューを使って表示されることがポリシーで決められています。

Windowsでは、Qt WebView Qt WebEngineモジュールとWebView2の両方を使用してコンテンツをレンダリングします。

Linuxでは、Qt WebView Qt WebEngineモジュールに依存します。

macOSでは、iOSと同様にシステムウェブビューが使用されます。

前提条件

QtWebView モジュールをすべてのプラットフォームで正しく機能させるには、Qt モジュールを作成する前に QtWebView::initialize()インスタンスを作成する前に QGuiApplicationインスタンスを作成する前と、ウィンドウの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 QML Types
• Qt WebView C++ Classes and Namespaces

ライセンス

Qt WebView は、The Qt Company の商用ライセンスで入手できます。さらに、GNU Lesser General Public License, version 3 またはGNU General Public License, version 2 の下でも利用可能です。詳細はQt Licensingを参照してください。