Auf dieser Seite

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.

view.runJavaScript("document.title", [](const QVariant &v) { qDebug() << v.toString(); });

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