WebView QML Type

Eine Komponente zur Anzeige von Webinhalten. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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)
• httpUserAgentChanged(string userAgent)
• loadProgressChanged(int loadProgress)
• loadingChanged(WebViewLoadRequest loadRequest)
• titleChanged(string title)
• urlChanged(url url)

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.

Dokumentation der Eigenschaften

canGoBack : bool [read-only]

Hält true, wenn es derzeit möglich ist, in der Web-Historie zurück zu navigieren.

canGoForward : bool [read-only]

Hält true, wenn es derzeit möglich ist, in der Web-Historie vorwärts zu navigieren.

httpUserAgent : url [since QtWebView 1.14]

Der verwendete Benutzeragent.

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]

Hält true, wenn WebView gerade neue Inhalte lädt, ansonsten 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. Wenn Sie diese ändern, wird ein neuer Inhalt geladen.

Die URL wird so verwendet, wie sie ist. URLs, die von Benutzereingaben stammen, sollten mit QUrl::fromUserInput() geparst werden.

Signal-Dokumentation

cookieAdded(string domain, string name)

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

Die Parameter liefern Informationen über die domain und die name des hinzugefügten Cookies.

cookieRemoved(string domain, string name)

Dieses Signal wird ausgesendet, wenn ein Cookie gelöscht wird.

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

httpUserAgentChanged(string userAgent)

Dieses Signal wird ausgegeben, wenn sich die userAgent der Ansicht ändert.

Siehe auch httpUserAgent.

loadProgressChanged(int loadProgress)

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

Siehe auch loadingChanged.

loadingChanged(WebViewLoadRequest loadRequest)

Dieses Signal wird ausgegeben, wenn sich der Status des Ladevorgangs des Webinhalts ändert. Durch die Verarbeitung dieses Signals ist es zum Beispiel 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, der eine Fehlermeldung für eine fehlgeschlagene Anfrage enthält.

Siehe auch WebViewLoadRequest.

titleChanged(string title)

Dieses Signal wird ausgegeben, wenn sich die title der Ansicht ändert.

Siehe auch title.

urlChanged(url url)

Dieses Signal wird ausgegeben, wenn sich die url der Ansicht ändert.

Siehe auch url.

Dokumentation der Methode

[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 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 zurück in den Webverlauf.

void goForward()

Navigiert im Webverlauf vorwärts.

void loadHtml(string html, url baseUrl)

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

Diese Methode bietet eine Alternative auf niedrigerer Ebene zur Eigenschaft url, 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.

Siehe auch url.

void reload()

Lädt die aktuelle url neu.

void runJavaScript(string script, variant callback)

Führt das angegebene JavaScript aus. Falls eine callback Funktion angegeben ist, wird diese nach Beendigung der Ausführung von script aufgerufen.

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 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()

Stoppt das Laden der aktuellen url.