Qt WebView
Qt WebView können Sie Webinhalte innerhalb einer QML-Anwendung anzeigen. Um die Einbindung eines vollständigen Webbrowser-Stacks zu vermeiden, nutzt „ Qt WebView “ gegebenenfalls native APIs.
Dies ist auf mobilen Plattformen wie Android und iOS nützlich. Unter iOS schreiben die Richtlinien vor, dass alle Webinhalte über die Webansicht des Betriebssystems angezeigt werden müssen.
Unter Windows kann „ Qt WebView “ sowohl das Qt WebEngine „module“ als auch „WebView2“ zum Rendern von Inhalten nutzen.
Unter Linux ist „ Qt WebView “ auf das Qt WebEngine Modul, um Inhalte darzustellen.
Unter macOS wird die System-Webansicht auf dieselbe Weise wie unter iOS verwendet.
Voraussetzungen
WebView Damit das Qt XML-ph-0000@deepl.internal-Modul plattformübergreifend korrekt funktioniert, muss QtWebView::initialize() vor dem Erstellen der QGuiApplication Instanz und vor der Erstellung des „ QPlatformOpenGLContext “ des Fensters aufzurufen.
Verwendung des Moduls
QML-API
Die QML-Typen des Moduls sind über den Import ` QtWebView ` verfügbar. Um die Typen zu verwenden, fügen Sie die folgende Importanweisung in Ihre .qml-Datei ein:
import QtWebViewC++-API
Die Verwendung der C++-API eines Qt-Moduls erfordert die 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.
Erstellen 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 Informationen finden Sie in der Übersicht „Erstellen mit CMake “.
Erstellen mit qmake
Um das Modul für die Erstellung mit qmake zu konfigurieren, fügen Sie das Modul als Wert der Variablen ` QT ` in der `.pro`-Datei des Projekts hinzu:
QT += webviewEinschränkungen
Aufgrund von Plattformbeschränkungen wird die Überlappung von „ WebView “ mit anderen QML-Komponenten nicht unterstützt. Dies führt zu unvorhersehbaren Ergebnissen, die von Plattform zu Plattform variieren können. Anwendungen können sich zudem nicht darauf verlassen, dass Ereignisse im „ WebView “ in das Qt-Ereignisübermittlungssystem weitergeleitet werden. So ist es beispielsweise nicht möglich, ein unsichtbares Element über den „ WebView “ zu „legen“, um bestimmte Ereignisse zu verarbeiten, oder Ereignisse zu verarbeiten, die der „ WebView “ in einem übergeordneten Element nicht verarbeitet.
Beispiele
In den Beispielen unter Qt WebView finden Sie eine Demonstration, wie die APIs in Anwendungen genutzt werden können.
Referenz
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, verfügbar. Weitere Details finden Sie unter Qt-Lizenzierung.
© 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.