Sur cette page

QWebView Class

La classe QWebView fournit une fenêtre permettant d'afficher du contenu Web. En savoir plus...

En-tête : #include <QWebView>
CMake : find_package(Qt6 REQUIRED COMPONENTS WebView)
target_link_libraries(mytarget PRIVATE Qt6::WebView)
qmake : QT += webview
Depuis : Qt 6.11
Hérite de : QWindow

Propriétés

Fonctions publiques

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

Emplacements publics

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

Signaux

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)

Fonctions protégées réimplémentées

virtual bool event(QEvent *e) override

Description détaillée

Une vue Web est une fenêtre permettant d'afficher du contenu Web, implémentée à l'aide d'API natives sur les plateformes où celles-ci sont disponibles. Par conséquent, elle ne nécessite pas forcément l'intégration d'une pile de navigateur Web complète au sein de l'application.

Un site Web peut être chargé dans une vue Web à l'aide de la fonction setUrl().

Sinon, si vous disposez déjà du contenu HTML, vous pouvez utiliser setHtml() à la place.

Le signal loadingChanged() est émis lorsque la vue commence à se charger et lorsqu’elle est entièrement chargée. Son argument, l’objet QWebViewLoadRequest, indique si le chargement a réussi ou échoué.

Le titre d’un document HTML est accessible via la propriété ` title()`.

Documentation sur les propriétés

httpUserAgentString : QString

Cette propriété contient l'agent utilisateur en cours d'utilisation. Il s'agit de la chaîne « user-agent » envoyée via HTTP pour identifier le navigateur.

Fonctions d'accès :

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

Signal de notification :

void httpUserAgentStringChanged(const QString &userAgent)

[read-only] loadProgress : int

Progression actuelle du chargement du contenu Web, représentée par un nombre entier compris entre 0 et 100.

Fonctions d'accès :

int loadProgress() const

Signal de notification :

void loadProgressChanged(int loadProgress)

[read-only] loading : bool

Renvoie « true » si l'WebView est en train de charger du nouveau contenu, « false » dans le cas contraire.

Fonctions d’accès :

bool isLoading() const

Signal de notification :

void loadingChanged(const QWebViewLoadingInfo &loadingInfo)

[read-only] settings : QWebViewSettings* const

Objet de paramètres pour l'QWebView. Les paramètres d'une vue Web.

Fonctions d'accès :

QWebViewSettings *settings() const

Voir aussi WebViewSettings.

title : QString

Cette propriété contient le titre de la page Web actuellement chargée.

Le titre de la page tel que défini par l'élément HTML ` <title> `.

Fonctions d'accès :

QString title() const

Signal de notification :

void titleChanged(const QString &title)

Voir aussi titleChanged().

url : QUrl

Cette propriété contient l'URL de la page Web actuellement affichée.

La définition de cette propriété efface l'affichage et charge l'URL. Par défaut, cette propriété contient une URL vide et non valide. Les URL provenant d'une saisie utilisateur doivent être analysées à l'aide de la fonction QUrl::fromUserInput().

Remarque : la fonction QWebView ne prend pas en charge le chargement de contenu via le système de ressources Qt.

Fonctions d'accès :

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

Signal de notification :

void urlChanged(const QUrl &url)

Voir également ` loadingChanged()`.

Documentation des fonctions membres

bool QWebView::canGoBack() const

Renvoie ` true ` s'il est actuellement possible de revenir en arrière dans l'historique de navigation.

bool QWebView::canGoForward() const

Renvoie « true » s'il est actuellement possible d'avancer dans l'historique de navigation.

[signal] void QWebView::cookieAdded(const QString &domain, const QString &name)

Ce signal est émis lorsqu'un cookie est ajouté.

Les paramètres fournissent des informations sur l'domain et l'name du cookie ajouté.

Remarque : lorsque le module Qt WebEngine est utilisé comme backend, le signal `cookieAdded` est émis pour tout cookie ajouté à l’ QWebEngineCookieStore sous-jacente, y compris ceux ajoutés par des sites web. Dans les autres cas, le signal `cookieAdded` n’est émis que pour les cookies explicitement ajoutés à l’aide de la fonction ` setCookie()`.

[signal] void QWebView::cookieRemoved(const QString &domain, const QString &name)

Ce signal est émis lorsqu'un cookie est supprimé. Les paramètres fournissent des informations sur l'domain e et l'name e du cookie supprimé.

[slot] void QWebView::deleteAllCookies()

Supprime tous les cookies.

[slot] void QWebView::deleteCookie(const QString &domain, const QString &name)

Supprime un cookie dont les paramètres « domain » et « name » sont ceux indiqués.

Le signal cookieRemoved() sera émis lorsque le cookie sera supprimé.

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

Réimplémente : QWindow::event(QEvent *ev).

[slot] void QWebView::goBack()

Permet de revenir en arrière dans l'historique de navigation.

[slot] void QWebView::goForward()

Permet d'avancer dans l'historique de navigation.

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

Ce signal est émis chaque fois que la propriété « userAgent » de la vue change.

Remarque : signalde notification pour l'httpUserAgentString de la propriété.

[slot] void QWebView::loadHtml(const QString &html, const QUrl &baseUrl = QUrl())

Charge le contenu html spécifié dans la vue Web.

Cette méthode offre une alternative de plus bas niveau à la propriété ` url `, qui référence des pages HTML via une URL.

Les objets externes tels que les feuilles de style ou les images référencées dans le document HTML doivent être situés par rapport à ` baseUrl`. Par exemple, si html est récupéré à partir de http://www.example.com/documents/overview.html, qui est l'URL de base, alors une image référencée par l'URL relative diagram.png doit se trouver à l'adresse http://www.example.com/documents/diagram.png.

Remarque : l’ QWebView ne prend pas en charge le chargement de contenu via le système de ressources Qt.

[signal] void QWebView::loadProgressChanged(int loadProgress)

Ce signal est émis en continu pendant le chargement d'une page Web. Le paramètre « loadProgress » est une valeur comprise entre 0 et 100, indiquant le pourcentage de la page Web qui a été chargé. Il est destiné à permettre l'affichage d'une barre de progression à l'utilisateur.

Remarque : certains backends ne prennent pas en charge les variations fractionnaires de la progression du chargement et n'émettront ce signal qu'au début et à la fin d'un chargement, avec des valeurs de 0 et 100, respectivement.

Remarque : signalde notification pour la propriété loadProgress.

Voir également loadingChanged.

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

Ce signal est émis lorsque l'état de chargement du contenu Web change. En gérant ce signal, il est possible, par exemple, de réagir aux erreurs de chargement de la page.

Le paramètre ` loadingInfo ` contient l'URL et le statut de la requête, ainsi qu'une chaîne `errorString` renfermant un message d'erreur en cas d'échec de la requête.

Remarque : signalNotifier pour la propriété loading.

Voir également loadProgressChanged et QWebViewLoadingInfo.

[slot] void QWebView::reload()

Recharge l'url.

void QWebView::runJavaScript(const QString &script, const std::function<void (const QVariant &)> &resultCallback = {})

Exécute le code JavaScript spécifié. Si une fonction ` resultCallback ` est fournie, elle sera appelée une fois l'exécution de ` script ` terminée.

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

[slot] void QWebView::setCookie(const QString &domain, const QString &name, const QString &value)

Ajoute un cookie avec les valeurs spécifiées : domain, name et value. Le signal cookieAdded() sera émis lorsque le cookie sera ajouté.

[slot] void QWebView::stop()

Arrête le chargement de l'url.

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

Ce signal est émis chaque fois que la propriété « title » de la vue change.

Remarque : signalde notification pour la propriété ` title`.

Voir également ` title()`

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

Ce signal est émis chaque fois que la propriété « url » de la vue change.

Remarque : signalde notification pour la propriété ` url`.

Voir également ` 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.