QWebView Class
Die Klasse „QWebView“ stellt ein Fenster zur Verfügung, das zur Anzeige von Webinhalten dient. Mehr...
| Kopfzeile: | #include <QWebView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebView) target_link_libraries(mytarget PRIVATE Qt6::WebView) |
| qmake: | QT += webview |
| Seit: | Qt 6.11 |
| Erbt von: | QWindow |
Eigenschaften
|
Öffentliche Funktionen
| bool | canGoBack() const |
| bool | canGoForward() const |
| QString | httpUserAgentString() const |
| bool | isLoading() const |
| int | loadProgress() const |
| void | runJavaScript(const QString &script, const std::function<void (const QVariant &)> &resultCallback = {}) |
| QWebViewSettings * | settings() const |
| QString | title() const |
| QUrl | url() const |
Öffentliche Slots
| void | deleteAllCookies() |
| void | deleteCookie(const QString &domain, const QString &name) |
| void | goBack() |
| void | goForward() |
| void | loadHtml(const QString &html, const QUrl &baseUrl = QUrl()) |
| void | reload() |
| void | setCookie(const QString &domain, const QString &name, const QString &value) |
| void | setHttpUserAgentString(const QString &httpUserAgent) |
| void | setUrl(const QUrl &url) |
| void | stop() |
Signale
| void | cookieAdded(const QString &domain, const QString &name) |
| void | cookieRemoved(const QString &domain, const QString &name) |
| void | httpUserAgentStringChanged(const QString &userAgent) |
| void | loadProgressChanged(int loadProgress) |
| void | loadingChanged(const QWebViewLoadingInfo &loadingInfo) |
| void | titleChanged(const QString &title) |
| void | urlChanged(const QUrl &url) |
Neu implementierte geschützte Funktionen
| virtual bool | event(QEvent *e) override |
Ausführliche Beschreibung
Eine Webansicht ist ein Fenster zur Anzeige von Webinhalten, das auf den Plattformen, auf denen dies möglich ist, mithilfe nativer APIs implementiert wird. Daher ist es nicht unbedingt erforderlich, einen vollständigen Webbrowser-Stack als Teil der Anwendung einzubinden.
Eine Website kann mit der Funktion ` setUrl()` in eine Webansicht geladen werden.
Alternativ können Sie, falls Ihnen der HTML-Inhalt bereits vorliegt, stattdessen setHtml() verwenden.
Das Signal ` loadingChanged()` wird ausgelöst, wenn die Ansicht mit dem Laden beginnt und wenn die Ansicht vollständig geladen wurde. Das zugehörige `QWebViewLoadRequest`-Objekt gibt an, ob das Laden erfolgreich war oder fehlgeschlagen ist.
Auf den Titel eines HTML-Dokuments kann über die Eigenschaft ` title()` zugegriffen werden.
Dokumentation zu den Eigenschaften
httpUserAgentString : QString
Diese Eigenschaft enthält den verwendeten User-Agent. Dabei handelt es sich um die User-Agent-Zeichenkette, die per HTTP gesendet wird, um den Browser zu identifizieren.
Zugriffsfunktionen:
| QString | httpUserAgentString() const |
| void | setHttpUserAgentString(const QString &httpUserAgent) |
Notifier-Signal:
| void | httpUserAgentStringChanged(const QString &userAgent) |
[read-only] loadProgress : int
Der aktuelle Ladefortschritt des Webinhalts, dargestellt als Ganzzahl zwischen 0 und 100.
Zugriffsfunktionen:
| int | loadProgress() const |
Benachrichtigungssignal:
| void | loadProgressChanged(int loadProgress) |
[read-only] loading : bool
Enthält „ true “, wenn die „ WebView “ gerade dabei ist, neue Inhalte zu laden, andernfalls „ false “.
Zugriffsfunktionen:
| bool | isLoading() const |
Notifier-Signal:
| void | loadingChanged(const QWebViewLoadingInfo &loadingInfo) |
[read-only] settings : QWebViewSettings* const
Einstellungsobjekt für die „ QWebView “. Die Einstellungen für eine Webansicht.
Zugriffsfunktionen:
| QWebViewSettings * | settings() const |
Siehe auch „ WebViewSettings “.
title : QString
Diese Eigenschaft enthält den Titel der aktuell geladenen Webseite.
Der Titel der Seite, wie er durch das HTML-Element „ <title> “ definiert ist.
Zugriffsfunktionen:
| QString | title() const |
Notifier-Signal:
| void | titleChanged(const QString &title) |
Siehe auch ` titleChanged()`.
url : QUrl
Diese Eigenschaft enthält die URL der aktuell angezeigten Webseite.
Das Setzen dieser Eigenschaft löscht die Ansicht und lädt die URL. Standardmäßig enthält diese Eigenschaft eine leere, ungültige URL. URLs, die aus Benutzereingaben stammen, sollten mit ` QUrl::fromUserInput()` geparst werden.
Hinweis: ` QWebView ` unterstützt das Laden von Inhalten über das Qt-Ressourcensystem nicht.
Zugriffsfunktionen:
| QUrl | url() const |
| void | setUrl(const QUrl &url) |
Notifier-Signal:
| void | urlChanged(const QUrl &url) |
Siehe auch ` loadingChanged()`.
Dokumentation zu den Mitgliedsfunktionen
bool QWebView::canGoBack() const
Gibt „ true “ zurück, wenn es derzeit möglich ist, im Webverlauf zurückzuspringen.
bool QWebView::canGoForward() const
Gibt „ true “ zurück, wenn es derzeit möglich ist, im Webverlauf vorwärts zu navigieren.
[signal] void QWebView::cookieAdded(const QString &domain, const QString &name)
Dieses Signal wird ausgesendet, wenn ein Cookie hinzugefügt wird.
Die Parameter liefern Informationen über den domain und den 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 zugrunde liegenden „ QWebEngineCookieStore “ hinzugefügt wird, einschließlich der von Websites hinzugefügten Cookies. In allen anderen Fällen wird das Signal „cookieAdded“ nur für Cookies ausgegeben, die explizit mit „ setCookie()“ hinzugefügt wurden.
[signal] void QWebView::cookieRemoved(const QString &domain, const QString &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.
[slot] void QWebView::deleteAllCookies()
Löscht alle Cookies.
[slot] void QWebView::deleteCookie(const QString &domain, const QString &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.
[override virtual protected] bool QWebView::event(QEvent *e)
Implementiert neu: ` QWindow::event(QEvent *ev)`.
[slot] void QWebView::goBack()
Wechselt im Webverlauf eine Seite zurück.
[slot] void QWebView::goForward()
Springt im Webverlauf vorwärts.
[signal] void QWebView::httpUserAgentStringChanged(const QString &userAgent)
Dieses Signal wird immer dann ausgelöst, wenn sich die Eigenschaft „ userAgent “ der Ansicht ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ httpUserAgentString “.
[slot] void QWebView::loadHtml(const QString &html, const QUrl &baseUrl = QUrl())
Lädt den angegebenen Inhalt von „ 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` verweisen. 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: „ QWebView “ unterstütztdas Laden von Inhalten über das Qt-Ressourcensystem nicht.
[signal] void QWebView::loadProgressChanged(int loadProgress)
Dieses Signal wird während des Ladens einer Webseite kontinuierlich ausgesendet. 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 bruchteiligen Änderungen des Ladefortschritts und senden dieses Signal nur zu Beginn und am Ende eines Ladevorgangs mit den Werten 0 bzw. 100 aus.
Hinweis: Notifier -Signal für die Eigenschaft „ loadProgress “.
Siehe auch „ loadingChanged “.
[signal] void QWebView::loadingChanged(const QWebViewLoadingInfo &loadingInfo)
Dieses Signal wird ausgelöst, wenn sich der Status beim Laden der Webinhalte ändert. Durch die Verarbeitung dieses Signals ist es beispielsweise möglich, auf Fehler beim Laden der Seite zu reagieren.
Der Parameter „ loadingInfo “ enthält die URL und den Status der Anfrage sowie einen „errorString“ mit einer Fehlermeldung für eine fehlgeschlagene Anfrage.
Hinweis: Notifier -Signal für die Eigenschaft „ loading “.
Siehe auch „ loadProgressChanged “ und „ QWebViewLoadingInfo “.
[slot] void QWebView::reload()
Lädt die aktuelle Seite „ url “ neu.
void QWebView::runJavaScript(const QString &script, const std::function<void (const QVariant &)> &resultCallback = {})
Führt das angegebene JavaScript aus. Falls eine Funktion „ resultCallback “ angegeben ist, wird diese aufgerufen, nachdem die Ausführung von „ script “ abgeschlossen ist.
[slot] void QWebView::setCookie(const QString &domain, const QString &name, const QString &value)
Fügt ein Cookie mit den angegebenen Werten „ domain “, „ name “ und „ value “ hinzu. Das Signal „ cookieAdded()“ wird ausgelöst, sobald das Cookie hinzugefügt wurde.
[slot] void QWebView::stop()
Beendet das Laden des aktuellen url.
[signal] void QWebView::titleChanged(const QString &title)
Dieses Signal wird immer dann ausgelöst, wenn sich die Eigenschaft „ title “ der Ansicht ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ title “.
Siehe auch „ title()“.
[signal] void QWebView::urlChanged(const QUrl &url)
Dieses Signal wird immer dann ausgelöst, wenn sich die Eigenschaft „ url “ der Ansicht ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ url “.
Siehe auch „ 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.