QWebView Class
La clase QWebView proporciona una ventana que se utiliza para ver contenido web. Más...
| Cabecera: | #include <QWebView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebView)target_link_libraries(mytarget PRIVATE Qt6::WebView) |
| qmake: | QT += webview |
| Desde: | Qt 6.11 |
| Hereda: | QWindow |
Propiedades
|
Funciones públicas
| bool | canGoBack() const |
| bool | canGoForward() const |
| QString | httpUserAgentString() const |
| bool | isLoading() const |
| int | loadProgress() const |
| QWebViewSettings * | settings() const |
| QString | title() const |
| QUrl | url() const |
Ranuras públicas
| 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() |
Señales
| 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 utilizando APIs 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().
Alternativamente, si usted tiene el contenido HTML fácilmente disponible, puede utilizar setHtml() en su lugar.
La señal loadingChanged() se emite cuando la vista comienza a cargarse y cuando la vista se ha cargado completamente. Su argumento, el objeto QWebViewLoadRequest, indica si la carga se ha realizado correctamente o no.
Se puede acceder al título de un documento HTML con la propiedad title().
Documentación de Propiedades
httpUserAgentString : QString
Esta propiedad contiene el agente de usuario en uso. La cadena de agente de usuario enviada con HTTP para identificar el navegador.
Funciones de acceso:
| QString | httpUserAgentString() const |
| void | setHttpUserAgentString(const QString &httpUserAgent) |
Señal del notificador:
| void | httpUserAgentStringChanged(const QString &userAgent) |
[read-only] loadProgress : int
El progreso de carga actual del contenido web, representado como un número entero entre 0 y 100.
Funciones de acceso:
| int | loadProgress() const |
Señal del notificador:
| void | loadProgressChanged(int loadProgress) |
[read-only] loading : bool
Indica true si WebView está cargando nuevos contenidos, false en caso contrario.
Funciones de acceso:
| bool | isLoading() const |
Señal del notificador:
| void | loadingChanged(const QWebViewLoadingInfo &loadingInfo) |
[read-only] settings : QWebViewSettings* const
Objeto de configuración para el 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 se define mediante el elemento HTML <title>.
Funciones de acceso:
| QString | title() const |
Señal del notificador:
| void | titleChanged(const QString &title) |
Véase también titleChanged().
url : QUrl
Esta propiedad contiene la URL de la página web actualmente visualizada.
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 URLs que se originan de la entrada del usuario deben ser analizadas con QUrl::fromUserInput().
Nota: QWebView no permite cargar contenido a través del sistema de recursos de Qt.
Funciones de acceso:
| QUrl | url() const |
| void | setUrl(const QUrl &url) |
Señal notificadora:
| void | urlChanged(const QUrl &url) |
Véase también loadingChanged().
Documentación de las funciones miembro
bool QWebView::canGoBack() const
Devuelve true si actualmente es posible navegar hacia atrás en el historial web.
bool QWebView::canGoForward() const
Devuelve true si actualmente es posible navegar hacia adelante en el historial web.
[slot] void QWebView::deleteAllCookies()
Borra todas las cookies.
[override virtual protected] bool QWebView::event(QEvent *e)
Reimplementa: QWindow::event(QEvent *ev).
[slot] void QWebView::goBack()
Navega hacia atrás en el historial de la web.
[slot] void QWebView::goForward()
Navega hacia adelante en el historial de la web.
[signal] void QWebView::httpUserAgentStringChanged(const QString &userAgent)
Esta señal se emite cada vez que cambia el userAgent de la vista.
Nota: Señal notificadora para la propiedad httpUserAgentString.
Véase también httpUserAgent().
[slot] void QWebView::loadHtml(const QString &html, const QUrl &baseUrl = QUrl())
Carga el contenido especificado de html en la vista web.
Este método ofrece una alternativa de nivel inferior a la propiedad url, que hace referencia a páginas HTML mediante URL.
Los objetos externos, como las hojas de estilo o las imágenes a las que se hace referencia en el documento HTML, deben ubicarse en relación con baseUrl. Por ejemplo, si html se recupera de http://www.example.com/documents/overview.html, que es la URL base, entonces una imagen referenciada con la URL relativa diagram.png, debería estar en http://www.example.com/documents/diagram.png.
Nota: QWebView no admite la carga de contenidos a través del sistema de recursos Qt.
[signal] void QWebView::loadProgressChanged(int loadProgress)
Esta señal se emite continuamente durante la carga de una página web. El parámetro loadProgress es un valor entre 0 y 100, que indica qué porcentaje de la página web se ha cargado. El uso previsto para esto es mostrar una barra de progreso al usuario.
Nota: Algunos backends no soportan cambios de progreso de carga fraccionados, y sólo emitirán esta señal al principio y al final de una carga, con valores de 0 y 100, respectivamente.
Nota: Señal notificadora 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 carga del contenido web. Manejando esta señal es posible, por ejemplo, reaccionar ante errores de carga de la página.
El parámetro loadingInfo contiene la url y el estado de la petición, así como un errorString que contiene un mensaje de error para una petición fallida.
Nota: Señal notificadora para la propiedad loading.
Véase también loadProgressChanged y QWebViewLoadingInfo.
[slot] void QWebView::reload()
Vuelve a cargar la página url.
[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 el title de la vista.
Nota: Señal notificadora 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 el url de la vista.
Nota: Señal notificadora 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.
