Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

WebView QML Type

Eine Komponente zur Anzeige von Webinhalten. Mehr...

Import Statement: import QtWebView

Eigenschaften

Signale

Methoden

Ausführliche Beschreibung

WebView ist eine Komponente zur Darstellung von Webinhalten, die auf den Plattformen, auf denen dies möglich ist, mithilfe nativer APIs implementiert wird, sodass nicht zwingend ein vollständiger Webbrowser-Stack als Teil der Anwendung erforderlich ist.

Damit das Modul „ Qt WebView “ auf allen Plattformen korrekt funktioniert, muss unmittelbar nach der Erstellung der Instanz „ QGuiApplication “ die Methode „ QtWebView::initialize()“ aufgerufen werden.

Hinweis: Aufgrund von Plattformbeschränkungen wird das Überlappen von `WebView` und anderen QML-Komponenten nicht unterstützt.

Dokumentation zu den Eigenschaften

canGoBack : bool [read-only]

Enthält den Wert „ true “, wenn es derzeit möglich ist, im Webverlauf zurückzuspringen.

canGoForward : bool [read-only]

Enthält „ true “, wenn es derzeit möglich ist, im Webverlauf vorwärts zu navigieren.

httpUserAgent : url [since QtWebView 1.14]

Der verwendete User-Agent.

Diese Eigenschaft wurde in QtWebView 1.14 eingeführt.

loadProgress : int [read-only]

Der aktuelle Ladefortschritt des Webinhalts, dargestellt als Ganzzahl zwischen 0 und 100.

loading : bool [read-only]

Enthält „ true “, wenn die „ WebView “ gerade dabei ist, neue Inhalte zu laden, andernfalls „ false “.

Siehe auch loadingChanged().

settings : WebViewSettings [read-only, since QtWebView 6.5]

Einstellungsobjekt für die „ WebView “.

Diese Eigenschaft wurde in QtWebView 6.5 eingeführt.

Siehe auch „ WebViewSettings “.

title : string [read-only]

Der Titel der aktuell geladenen Webseite.

url : url

Die URL der aktuell geladenen Webseite. Eine Änderung dieser Angabe führt zum Laden neuer Inhalte.

Die URL wird unverändert verwendet. URLs, die aus Benutzereingaben stammen, sollten mit ` QUrl::fromUserInput()` geparst werden.

Hinweis: Die Funktion ` WebView ` unterstützt das Laden von Inhalten über das Qt-Ressourcensystem nicht.

Signal-Dokumentation

cookieAdded(string domain, string name)

Dieses Signal wird ausgegeben, wenn ein Cookie hinzugefügt wird.

Die Parameter liefern Informationen über das Modul „ domain “ und die „ name “ des hinzugefügten Cookies.

Hinweis: Wenn das Modul „ Qt WebEngine “ als Backend verwendet wird, wird das Signal „cookieAdded“ für jedes Cookie ausgelöst, das dem zugrunde liegenden „ QWebEngineCookieStore “ hinzugefügt wird, einschließlich der von Websites hinzugefügten Cookies. In anderen Fällen wird das Signal „cookieAdded“ nur für Cookies ausgelöst, die explizit mit „ setCookie()“ hinzugefügt wurden.

Hinweis: Der entsprechende Handler ist „ onCookieAdded “.

cookieRemoved(string domain, string name)

Dieses Signal wird ausgelöst, wenn ein Cookie gelöscht wird.

Die Parameter enthalten Informationen über die domain und die name des gelöschten Cookies.

Hinweis: Der entsprechende Handler lautet onCookieRemoved.

httpUserAgentChanged(string userAgent)

Dieses Signal wird immer dann ausgelöst, wenn sich das „ userAgent “ der Ansicht ändert.

Hinweis: Der entsprechende Handler ist ` onHttpUserAgentChanged`.

Siehe auch ` httpUserAgent`.

loadProgressChanged(int loadProgress)

Dieses Signal wird während des Ladens einer Webseite kontinuierlich ausgegeben. Der Parameter „ loadProgress “ ist ein Wert zwischen 0 und 100, der angibt, wie viel Prozent der Webseite bereits geladen wurden. Dies dient dazu, dem Benutzer einen Fortschrittsbalken anzuzeigen.

Hinweis: Einige Backends unterstützen keine fraktionierten Änderungen des Ladefortschritts und senden dieses Signal nur zu Beginn und am Ende eines Ladevorgangs mit den Werten 0 bzw. 100 aus.

Hinweis: Der entsprechende Handler ist „ onLoadProgressChanged “.

Siehe auch loadingChanged.

loadingChanged(WebViewLoadRequest loadRequest)

Dieses Signal wird ausgelöst, wenn sich der Status beim Laden des Webinhalts ändert. Durch die Verarbeitung dieses Signals ist es beispielsweise möglich, auf Fehler beim Laden der Seite zu reagieren.

Der Parameter „ loadRequest “ enthält die URL und den Status der Anfrage sowie einen „errorString“ mit einer Fehlermeldung für eine fehlgeschlagene Anfrage.

Hinweis: Der entsprechende Handler lautet „ onLoadingChanged “.

Siehe auch „ WebViewLoadRequest “.

titleChanged(string title)

Dieses Signal wird immer dann ausgelöst, wenn sich die „ title “ der Ansicht ändert.

Hinweis: Der entsprechende Handler lautet „ onTitleChanged “.

Siehe auch „ title “.

urlChanged(url url)

Dieses Signal wird immer dann ausgelöst, wenn sich die ` url ` der Ansicht ändert.

Hinweis: Der entsprechende Handler lautet „ onUrlChanged “.

Siehe auch „ url “.

Methodendokumentation

[since QtWebView 6.3] void deleteAllCookies()

Löscht alle Cookies.

Diese Methode wurde in QtWebView 6.3 eingeführt.

[since QtWebView 6.3] void deleteCookie(string domain, string name)

Löscht ein Cookie mit den angegebenen Werten für „ domain “ und „ name “.

Das Signal „ cookieRemoved “ wird ausgelöst, wenn das Cookie gelöscht wird.

Diese Methode wurde in QtWebView 6.3 eingeführt.

void goBack()

Wechselt im Webverlauf eine Seite zurück.

void goForward()

Springt im Webverlauf vorwärts.

void loadHtml(string html, url baseUrl)

Lädt den angegebenen Inhalt unter html in die Webansicht.

Diese Methode bietet eine Alternative auf niedrigerer Ebene zur Eigenschaft „ url “, die über URLs auf HTML-Seiten verweist.

Externe Objekte wie Stylesheets oder Bilder, auf die im HTML-Dokument verwiesen wird, sollten relativ zu ` baseUrl` verortet sein. Wenn beispielsweise ` html ` von ` http://www.example.com/documents/overview.html` – der Basis-URL – abgerufen wird, sollte sich ein Bild, auf das mit der relativen URL ` diagram.png` verwiesen wird, unter ` http://www.example.com/documents/diagram.png` befinden.

Hinweis: „ WebView “ unterstütztdas Laden von Inhalten über das Qt-Ressourcensystem nicht.

Siehe auch url.

void reload()

Lädt die aktuelle Seite „ url “ neu.

void runJavaScript(string script, variant callback)

Führt das angegebene JavaScript aus. Falls eine Funktion „ callback “ angegeben ist, wird diese aufgerufen, nachdem die Ausführung von „ script “ abgeschlossen ist.

runJavaScript("document.title", function(result) { console.log(result); });

[since QtWebView 6.3] void setCookie(string domain, string name, string value)

Fügt ein Cookie mit den angegebenen Werten „ domain “, „ name “ und „ value “ hinzu.

Das Signal „ cookieAdded “ wird ausgelöst, wenn das Cookie hinzugefügt wird.

Diese Methode wurde in QtWebView 6.3 eingeführt.

void stop()

Beendet das Laden der aktuellen Seite url.

© 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.