En esta página

QWebView Class

La clase QWebView proporciona una ventana que se utiliza para visualizar contenido web. Más información...

Encabezado: #include <QWebView>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebView)
target_link_libraries(mytarget PRIVATE Qt6::WebView)
qmake: QT += webview
Desde: Qt 6.11
Heredado de: QWindow

Propiedades

Funciones públicas

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

Ranuras públicas

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

Señales

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)

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override

Descripción detallada

Una vista web es una ventana para mostrar contenido web que se implementa mediante API nativas en las plataformas en las que están disponibles. Por lo tanto, no requiere necesariamente incluir una pila completa de navegador web como parte de la aplicación.

Se puede cargar un sitio web en una vista web con la función setUrl().

Como alternativa, si se dispone del contenido HTML, se puede utilizar setHtml() en su lugar.

La señal loadingChanged() se emite cuando la vista comienza a cargarse y cuando se ha cargado por completo. Su argumento, el objeto QWebViewLoadRequest, indica si la carga se ha realizado correctamente o ha fallado.

Se puede acceder al título de un documento HTML mediante la propiedad ` title()`.

Documentación de la propiedad

httpUserAgentString : QString

Esta propiedad contiene el agente de usuario que se está utilizando. La cadena de agente de usuario enviada mediante HTTP para identificar el navegador.

Funciones de acceso:

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

Señal de notificación:

void httpUserAgentStringChanged(const QString &userAgent)

[read-only] loadProgress : int

El progreso actual de la carga del contenido web, representado como un número entero entre 0 y 100.

Funciones de acceso:

int loadProgress() const

Señal de notificación:

void loadProgressChanged(int loadProgress)

[read-only] loading : bool

Devuelve « true » si la página WebView está cargando contenido nuevo en ese momento; en caso contrario, devuelve « false ».

Funciones de acceso:

bool isLoading() const

Señal de notificación:

void loadingChanged(const QWebViewLoadingInfo &loadingInfo)

[read-only] settings : QWebViewSettings* const

Objeto de configuración para la vista web ( QWebView). La configuración de una vista web.

Funciones de acceso:

QWebViewSettings *settings() const

Véase también WebViewSettings.

title : QString

Esta propiedad contiene el título de la página web cargada actualmente.

El título de la página tal y como se define en el elemento HTML ` <title> `.

Funciones de acceso:

QString title() const

Señal de notificación:

void titleChanged(const QString &title)

Véase también ` titleChanged()`.

url : QUrl

Esta propiedad contiene la URL de la página web que se está viendo en ese momento.

Al establecer esta propiedad, se borra la vista y se carga la URL. Por defecto, esta propiedad contiene una URL vacía e inválida. Las URL que procedan de la entrada del usuario deben analizarse con QUrl::fromUserInput().

Nota: ` QWebView ` no admite la carga de contenido a través del sistema de recursos de Qt.

Funciones de acceso:

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

Señal de notificación:

void urlChanged(const QUrl &url)

Véase también ` loadingChanged()`.

Documentación de funciones de miembro

bool QWebView::canGoBack() const

Devuelve ` true ` si actualmente es posible retroceder en el historial web.

bool QWebView::canGoForward() const

Devuelve « true » si actualmente es posible avanzar en el historial web.

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

Esta señal se emite cuando se añade una cookie.

Los parámetros proporcionan información sobre el domain y el name de la cookie añadida.

Nota: Cuando se utiliza el módulo Qt WebEngine como backend, la señal cookieAdded se emitirá para cualquier cookie añadida al QWebEngineCookieStore subyacente, incluidas las añadidas por sitios web. En los demás casos, la señal cookieAdded solo se emite para las cookies añadidas explícitamente con setCookie().

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

Esta señal se emite cuando se elimina una cookie. Los parámetros proporcionan información sobre el domain y el name de la cookie eliminada.

[slot] void QWebView::deleteAllCookies()

Elimina todas las cookies.

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

Elimina una cookie con los valores especificados en « domain » y « name ».

Se emitirá la señal cookieRemoved() cuando se elimine la cookie.

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

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

[slot] void QWebView::goBack()

Permite retroceder en el historial de navegación.

[slot] void QWebView::goForward()

Avanza en el historial web.

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

Esta señal se emite cada vez que cambia la propiedad ` userAgent ` de la vista.

Nota: Señalde notificación para la propiedad ` httpUserAgentString`.

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

Carga el contenido especificado en ` html ` en la vista web.

Este método ofrece una alternativa de nivel más bajo a la propiedad url, que hace referencia a páginas HTML a través de una URL.

Los objetos externos, como las hojas de estilo o las imágenes a las que se hace referencia en el documento HTML, deben estar ubicados de forma relativa respecto a baseUrl. Por ejemplo, si html se recupera desde http://www.example.com/documents/overview.html, que es la URL base, entonces una imagen a la que se hace referencia con la URL relativa diagram.png debería estar en http://www.example.com/documents/diagram.png.

Nota: El QWebView no admite la carga de contenido a través del sistema de recursos de Qt.

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

Esta señal se emite de forma continua durante la carga de una página web. El parámetro « loadProgress » es un valor comprendido entre 0 y 100 que indica qué porcentaje de la página web se ha cargado. Su finalidad es mostrar una barra de progreso al usuario.

Nota: Algunos backends no admiten cambios fraccionarios en el progreso de la carga y solo emitirán esta señal al inicio y al final de la carga, con valores de 0 y 100, respectivamente.

Nota: Señalde notificador para la propiedad loadProgress.

Véase también loadingChanged.

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

Esta señal se emite cuando cambia el estado de la carga del contenido web. Al gestionar esta señal, es posible, por ejemplo, reaccionar ante errores en la carga de la página.

El parámetro ` loadingInfo ` contiene la URL y el estado de la solicitud, así como una cadena de error (`errorString` ) que incluye un mensaje de error en caso de que la solicitud haya fallado.

Nota: Señalde notificación para la propiedad loading.

Véase también loadProgressChanged y QWebViewLoadingInfo.

[slot] void QWebView::reload()

Vuelve a cargar el archivo « url » actual.

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

Ejecuta el código JavaScript especificado. En caso de que se proporcione una función ` resultCallback `, esta se invocará una vez que haya finalizado la ejecución de ` script `.

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

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

Añade una cookie con los valores especificados en domain, name y value. Se emitirá la señal cookieAdded() cuando se añada la cookie.

[slot] void QWebView::stop()

Detiene la carga de la página url.

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

Esta señal se emite cada vez que cambia la propiedad « title » de la vista.

Nota: Señalde notificador para la propiedad « title ».

Véase también ` title()`.

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

Esta señal se emite cada vez que cambia la propiedad ` url ` de la vista.

Nota: Señalde notificador para la propiedad ` url`.

Véase también ` 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.