Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QWebView Class

La classe QWebView fournit une fenêtre qui est utilisée pour visualiser le contenu web. Plus d'informations...

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 : QWindow

Propriétés

Fonctions publiques

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

Emplacements publics

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

Signaux

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 qui est mise en œuvre à l'aide d'API natives sur les plates-formes où elles sont disponibles. Par conséquent, il n'est pas nécessaire d'inclure un navigateur web complet dans l'application.

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

Par ailleurs, si vous disposez du contenu HTML, vous pouvez utiliser setHtml() à la place.

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

Le titre d'un document HTML est accessible à l'aide de la propriété title().

Documentation de la propriété

httpUserAgentString : QString

Cette propriété contient l'agent utilisateur utilisé. Il s'agit de la chaîne de l'agent utilisateur envoyée avec 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

L'état d'avancement du chargement du contenu web, représenté 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

Contient true si le site WebView est en train de charger un 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étrage pour le site QWebView. Paramétrage 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 est défini par l'élément HTML <title>.

Fonctions d'accès :

QString title() const

Signal Notifier :

void titleChanged(const QString &title)

Voir également titleChanged().

url : QUrl

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

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

Remarque : 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 Notifier :

void urlChanged(const QUrl &url)

Voir aussi loadingChanged().

Documentation des fonctions membres

bool QWebView::canGoBack() const

Renvoie true s'il est actuellement possible de naviguer en arrière dans l'historique du site web.

bool QWebView::canGoForward() const

Renvoie true s'il est actuellement possible de naviguer vers l'avant dans l'historique Web.

[slot] void QWebView::deleteAllCookies()

Supprime tous les cookies.

[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 du site web.

[slot] void QWebView::goForward()

Navigue vers l'avant dans l'historique du site web.

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

Ce signal est émis lorsque le site userAgent de la vue change.

Remarque : signal de notification pour la propriété httpUserAgentString.

Voir aussi httpUserAgent().

[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 niveau inférieur à la propriété url, qui référence les pages HTML via l'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, une image référencée avec l'URL relative diagram.png, doit se trouver à http://www.example.com/documents/diagram.png.

Remarque : QWebView ne prend pas en charge le chargement de contenu par l'intermédiaire du 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ée. L'utilisation prévue est l'affichage d'une barre de progression à l'intention de l'utilisateur.

Note : Certains backends ne supportent pas les changements de progression fractionnés et n'émettront ce signal qu'au début et à la fin d'un chargement, avec des valeurs de 0 et 100, respectivement.

Note : Signal de notification pour la propriété loadProgress.

Voir aussi loadingChanged.

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

Ce signal est émis lorsque l'état de chargement du contenu web change. En traitant 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 l'état de la demande, ainsi qu'une chaîne d'erreur (errorString ) contenant un message d'erreur en cas d'échec de la demande.

Note : Signal de notification pour la propriété loading.

Voir également loadProgressChanged et QWebViewLoadingInfo.

[slot] void QWebView::reload()

Recharge le site actuel url.

[slot] void QWebView::stop()

Arrêt du chargement du site actuel url.

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

Ce signal est émis lorsque le site title de la vue change.

Remarque : signal de notification pour la propriété title.

Voir également title().

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

Ce signal est émis lorsque le site url de la vue change.

Remarque : signal de 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.