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

QWebView Class

Die Klasse QWebView stellt ein Fenster zur Verfügung, das zum Betrachten von Webinhalten verwendet wird. 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
Vererbt: QWindow

Eigenschaften

Öffentliche Funktionen

bool canGoBack() const
bool canGoForward() const
QString httpUserAgentString() const
bool isLoading() const
int loadProgress() const
QWebViewSettings *settings() const
QString title() const
QUrl url() const

Öffentliche Slots

void deleteAllCookies()
void goBack()
void goForward()
void loadHtml(const QString &html, const QUrl &baseUrl = QUrl())
void reload()
void setHttpUserAgentString(const QString &httpUserAgent)
void setUrl(const QUrl &url)
void stop()

Signale

void httpUserAgentStringChanged(const QString &userAgent)
void loadProgressChanged(int loadProgress)
void loadingChanged(const QWebViewLoadingInfo &loadingInfo)
void titleChanged(const QString &title)
void urlChanged(const QUrl &url)

Reimplementierte geschützte Funktionen

virtual bool event(QEvent *e) override

Ausführliche Beschreibung

Eine Webansicht ist ein Fenster zur Anzeige von Webinhalten, das mit Hilfe von nativen APIs auf den Plattformen implementiert wird, auf denen sie verfügbar sind. 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.

Wenn Sie den HTML-Inhalt bereits zur Verfügung haben, können Sie stattdessen auch setHtml() verwenden.

Das Signal loadingChanged() wird ausgegeben, wenn der Ladevorgang der Ansicht beginnt und wenn die Ansicht vollständig geladen wurde. Sein Argument QWebViewLoadRequest Objekt zeigt an, ob das Laden erfolgreich war oder fehlgeschlagen ist.

Auf den Titel eines HTML-Dokuments kann mit der Eigenschaft title() zugegriffen werden.

Dokumentation der Eigenschaft

httpUserAgentString : QString

Diese Eigenschaft enthält den verwendeten User-Agent. Der User-Agent-String, der mit HTTP gesendet wird, um den Browser zu identifizieren.

Zugriffsfunktionen:

QString httpUserAgentString() const
void setHttpUserAgentString(const QString &httpUserAgent)

Benachrichtigungssignal:

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

Hält true, wenn WebView gerade neue Inhalte lädt, ansonsten false.

Zugriffsfunktionen:

bool isLoading() const

Benachrichtigungssignal:

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

Benachrichtigungssignal:

void titleChanged(const QString &title)

Siehe auch titleChanged().

url : QUrl

Diese Eigenschaft enthält die URL der aktuell angezeigten Webseite.

Durch das Setzen dieser Eigenschaft wird die Ansicht gelöscht und die URL geladen. Standardmäßig enthält diese Eigenschaft eine leere, ungültige URL. URLs, die von Benutzereingaben stammen, sollten mit QUrl::fromUserInput() geparst werden.

Hinweis: QWebView unterstützt nicht das Laden von Inhalten über das Qt Resource System.

Zugriffsfunktionen:

QUrl url() const
void setUrl(const QUrl &url)

Notifier-Signal:

void urlChanged(const QUrl &url)

Siehe auch loadingChanged().

Dokumentation der Mitgliedsfunktionen

bool QWebView::canGoBack() const

Gibt true zurück, wenn es derzeit möglich ist, in der Webhistorie zurück zu navigieren.

bool QWebView::canGoForward() const

Gibt true zurück, wenn es derzeit möglich ist, im Webverlauf vorwärts zu navigieren.

[slot] void QWebView::deleteAllCookies()

Löscht alle Cookies.

[override virtual protected] bool QWebView::event(QEvent *e)

Reimplements: QWindow::event(QEvent *ev).

[slot] void QWebView::goBack()

Navigiert zurück in den Webverlauf.

[slot] void QWebView::goForward()

Navigiert im Webverlauf vorwärts.

[signal] void QWebView::httpUserAgentStringChanged(const QString &userAgent)

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

Hinweis: Benachrichtigungssignal für die Eigenschaft httpUserAgentString.

Siehe auch httpUserAgent().

[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 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 abgerufen wird, das die Basis-URL ist, 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: QWebView unterstützt nicht das Laden von Inhalten über das Qt Resource System.

[signal] void QWebView::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.

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

Hinweis: Benachrichtigungssignal für die Eigenschaft loadProgress.

Siehe auch loadingChanged.

[signal] void QWebView::loadingChanged(const QWebViewLoadingInfo &loadingInfo)

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 loadingInfo enthält die URL und den Status der Anfrage, sowie einen errorString, der eine Fehlermeldung für eine fehlgeschlagene Anfrage enthält.

Hinweis: Melder-Signal für die Eigenschaft loading.

Siehe auch loadProgressChanged und QWebViewLoadingInfo.

[slot] void QWebView::reload()

Lädt die aktuelle url neu.

[slot] void QWebView::stop()

Stoppt das Laden der aktuellen url.

[signal] void QWebView::titleChanged(const QString &title)

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

Hinweis: Benachrichtigungssignal für die Eigenschaft title.

Siehe auch title().

[signal] void QWebView::urlChanged(const QUrl &url)

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

Hinweis: Benachrichtigungssignal 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.