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