WebView QML Type
Eine Komponente zur Anzeige von Webinhalten. Mehr...
| Import Statement: | import QtWebView |
Eigenschaften
- canGoBack : bool
- canGoForward : bool
- httpUserAgent : url
(since QtWebView 1.14) - loadProgress : int
- loading : bool
- settings : WebViewSettings
(since QtWebView 6.5) - title : string
- url : url
Signale
- cookieAdded(string domain, string name)
- cookieRemoved(string domain, string name)
- loadingChanged(WebViewLoadRequest loadRequest)
Methoden
- void deleteAllCookies()
(since QtWebView 6.3) - void deleteCookie(string domain, string name)
(since QtWebView 6.3) - void goBack()
- void goForward()
- void loadHtml(string html, url baseUrl)
- void reload()
- void runJavaScript(string script, variant callback)
- void setCookie(string domain, string name, string value)
(since QtWebView 6.3) - void stop()
Ausführliche Beschreibung
WebView ist eine Komponente für die Anzeige von Web-Inhalten, die unter Verwendung nativer APIs auf den Plattformen, auf denen diese verfügbar sind, implementiert wird, so dass es nicht unbedingt erforderlich ist, einen vollständigen Webbrowser-Stack als Teil der Anwendung einzubinden.
Damit das Modul Qt WebView auf allen Plattformen korrekt funktioniert, ist es notwendig, QtWebView::initialize() direkt nach der Erstellung der Instanz QGuiApplication aufzurufen.
Hinweis: Aufgrund von Plattformbeschränkungen wird die Überlappung von WebView und anderen QML-Komponenten nicht unterstützt.
Eigenschaft Dokumentation
canGoBack : bool |
Hält true, wenn es derzeit möglich ist, in der Webhistorie zurück zu navigieren.
canGoForward : bool |
Enthält true, wenn es derzeit möglich ist, in der Web-Historie vorwärts zu navigieren.
httpUserAgent : url |
Der verwendete Benutzeragent.
Hinweis: Unter WinRT betrifft diese Eigenschaft alle WebViews der Anwendung.
Diese Eigenschaft wurde in QtWebView 1.14 eingeführt.
loadProgress : int |
Der aktuelle Ladefortschritt des Webinhalts, dargestellt als Ganzzahl zwischen 0 und 100.
loading : bool |
Hält true, wenn WebView gerade neue Inhalte lädt, ansonsten false.
Siehe auch loadingChanged().
settings : WebViewSettings |
Einstellungsobjekt für die WebView.
Diese Eigenschaft wurde in QtWebView 6.5 eingeführt.
Siehe auch WebViewSettings.
title : string |
Der Titel der aktuell geladenen Webseite.
url : url |
Die URL der aktuell geladenen Webseite. Das Ändern dieser Eigenschaft löst das Laden neuer Inhalte aus.
Die URL wird so verwendet, wie sie ist. URLs, die aus Benutzereingaben stammen, sollten mit QUrl::fromUserInput() geparst werden.
Hinweis: WebView unterstützt nicht das Laden von Inhalten über das Qt Resource System.
Signal Dokumentation
Dieses Signal wird ausgesendet, wenn ein Cookie hinzugefügt wird.
Die Parameter liefern Informationen über die 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 ausgegeben, das dem zugrundeliegenden QWebEngineCookieStore hinzugefügt wurde, einschließlich derer, die von Websites hinzugefügt wurden. In anderen Fällen wird das cookieAdded-Signal nur für Cookies ausgegeben, die explizit mit setCookie() hinzugefügt wurden.
Hinweis: Der entsprechende Handler ist onCookieAdded.
Dieses Signal wird ausgegeben, wenn ein Cookie gelöscht wird.
Die Parameter liefern Informationen über domain und name des gelöschten Cookies.
Hinweis: Der entsprechende Handler ist onCookieRemoved.
loadingChanged(WebViewLoadRequest loadRequest) |
Dieses Signal wird ausgegeben, wenn sich der Status des Ladens des Webinhalts ändert. Durch die Behandlung dieses Signals kann z.B. auf Seitenladefehler reagiert werden.
Der Parameter loadRequest enthält die URL und den Status der Anfrage sowie einen errorString, der eine Fehlermeldung für eine fehlgeschlagene Anfrage enthält.
Hinweis: Der entsprechende Handler ist onLoadingChanged.
Siehe auch WebViewLoadRequest.
Dokumentation der Methode
|
Löscht alle Cookies.
Diese Methode wurde in QtWebView 6.3 eingeführt.
Löscht ein Cookie mit den angegebenen domain und name.
Das Signal cookieRemoved wird ausgegeben, wenn das Cookie gelöscht wird.
Diese Methode wurde in QtWebView 6.3 eingeführt.
void goBack() |
Navigiert in der Web-Historie zurück.
void goForward() |
Navigiert vorwärts in der Web History.
Lädt den angegebenen html Inhalt in die Webansicht.
Diese Methode bietet eine Alternative auf niedrigerer Ebene zur url Eigenschaft, die HTML-Seiten über eine URL referenziert.
Externe Objekte wie Stylesheets oder Bilder, auf die im HTML-Dokument verwiesen wird, sollten relativ zu baseUrl platziert werden. Wenn beispielsweise html von http://www.example.com/documents/overview.html, der Basis-URL, abgerufen wird, dann sollte ein Bild, auf das mit der relativen URL diagram.png verwiesen wird, unter http://www.example.com/documents/diagram.png zu finden sein.
Hinweis: WebView unterstützt nicht das Laden von Inhalten über das Qt Resource System.
Siehe auch url.
void reload() |
Lädt die aktuelle url neu.
Führt das angegebene JavaScript aus. Falls eine callback Funktion angegeben ist, wird diese aufgerufen, nachdem die script ausgeführt wurde.
runJavaScript("document.title", function(result) { console.log(result); });Fügt ein Cookie mit den angegebenen domain, name und value hinzu.
Das Signal cookieAdded wird ausgegeben, wenn das Cookie hinzugefügt wird.
Diese Methode wurde in QtWebView 6.3 eingeführt.
void stop() |
Beendet das Laden des aktuellen url.
© 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.
