Qt WebView

Qt WebView können Sie Webinhalte innerhalb einer QML-Anwendung anzeigen. Um einen vollständigen Webbrowser-Stack zu vermeiden, verwendet Qt WebView gegebenenfalls native APIs.

Dies ist auf mobilen Plattformen wie Android und iOS nützlich. Unter iOS wird der gesamte Webinhalt über die Webansicht des Betriebssystems angezeigt.

Unter Windows und Linux hängt Qt WebView von dem Qt WebEngine Modul ab, um Inhalte zu rendern.

Unter macOS wird die System-Webansicht auf die gleiche Weise wie unter iOS verwendet.

Voraussetzungen

Damit das Modul Qt WebView auf allen Plattformen korrekt funktioniert, ist es notwendig, den Aufruf QtWebView::initialize() vor der Erstellung der QGuiApplication Instanz und bevor das Fenster QPlatformOpenGLContext erstellt wird.

Verwendung des Moduls

QML-API

Die QML-Typen des Moduls sind über den QtWebView import verfügbar. Um die Typen zu verwenden, fügen Sie die folgende Import-Anweisung zu Ihrer .qml-Datei hinzu:

import QtWebView

C++-API

Die Verwendung der C++-API eines Qt-Moduls erfordert eine Verknüpfung mit der Modulbibliothek, entweder direkt oder über andere Abhängigkeiten. Mehrere Build-Tools bieten hierfür spezielle Unterstützung, darunter CMake und qmake.

Bauen mit CMake

Verwenden Sie den Befehl find_package(), um die benötigte Modulkomponente im Paket Qt6 zu finden:

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

Weitere Einzelheiten finden Sie in der Übersicht Bauen mit CMake.

Bauen mit qmake

Um das Modul für die Erstellung mit qmake zu konfigurieren, fügen Sie das Modul als Wert der Variable QT in der .pro-Datei des Projekts hinzu:

QT += webview

Begrenzungen

Aufgrund von Plattformbeschränkungen wird die Überlappung von WebView mit anderen QML-Komponenten nicht unterstützt. Dies führt zu unvorhersehbaren Ergebnissen, die sich von Plattform zu Plattform unterscheiden können. Anwendungen können sich auch nicht darauf verlassen, dass Ereignisse in WebView in das Qt-Ereignisübermittlungssystem weitergeleitet werden. Es ist z.B. nicht möglich, ein unsichtbares Element über WebView zu legen, um bestimmte Ereignisse zu verarbeiten, oder um Ereignisse zu verarbeiten, die WebView in einem übergeordneten Element nicht verarbeitet.

Beispiele

Unter Qt WebView Beispiele finden Sie eine Demonstration, wie die APIs in Anwendungen verwendet werden können.

Referenz

• Qt WebView QML Types
• Qt WebView C++ Classes and Namespaces

Lizenzen

Qt WebView ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter der GNU Lesser General Public License, Version 3, oder der GNU General Public License, Version 2, erhältlich. Siehe Qt Licensing für weitere Details.