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