QWebEnginePage Class

Documentación de las funciones miembro

[explicit] QWebEnginePage::QWebEnginePage(QObject *parent = nullptr)

Construye una QWebEnginePage vacía con el padre parent.

QWebEnginePage::QWebEnginePage(QWebEngineProfile *profile, QObject *parent = nullptr)

Construye una página de motor web vacía en el perfil de motor web profile con el padre parent.

Si el perfil no es el perfil por defecto, la persona que llama debe asegurarse de que el perfil permanece vivo durante el tiempo que dure la página.

[virtual noexcept] QWebEnginePage::~QWebEnginePage()

Destruye la página web.

[virtual protected] bool QWebEnginePage::acceptNavigationRequest(const QUrl &url, QWebEnginePage::NavigationType type, bool isMainFrame)

Esta función se llama al recibir una petición de navegación al url especificado mediante el tipo de navegación especificado type. isMainFrame indica si la petición corresponde al marco principal o a un marco hijo. Si la función devuelve true, se acepta la petición de navegación y se carga url. La implementación por defecto acepta todas las peticiones de navegación.

Las peticiones de navegación pueden delegarse a la aplicación Qt en lugar de que las procese el motor HTML handler sobrecargando esta función. Esto es necesario cuando se utiliza un documento HTML como parte de la interfaz de usuario, y no para mostrar datos externos, por ejemplo, cuando se muestra una lista de resultados.

La clase QWebEngineUrlRequestInterceptor ofrece más opciones para interceptar y manipular peticiones.

QAction *QWebEnginePage::action(QWebEnginePage::WebAction action) const

Devuelve un QAction para el WebAction action especificado.

La acción es propiedad de QWebEnginePage pero puedes personalizar su aspecto cambiando sus propiedades.

La acción devuelta no tiene un icono con estilo por defecto. Utilice QWebEngineView::pageAction() para obtener una acción con un icono por defecto.

QWebEnginePage también se encarga de implementar la acción, de forma que al dispararse se ejecute la acción correspondiente en la página.

Véase también triggerAction().

[signal] void QWebEnginePage::audioMutedChanged(bool muted)

Esta señal se emite cuando cambia el estado de la página muted.

[signal] void QWebEnginePage::authenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator)

Esta señal se emite cuando el acceso a requestUrl requiere autenticación. authenticator debe utilizarse para pasar el nombre de usuario y la contraseña de la conexión.

[signal] void QWebEnginePage::certificateError(const QWebEngineCertificateError &certificateError)

Esta señal se emite cuando se produce un error de certificado no válido al cargar una solicitud determinada.

El parámetro certificateError contiene información sobre el certificado y detalles del error, también proporciona la forma de ignorar el error y completar la petición o detener la carga de la petición.

Véase también QWebEngineCertificateError.

[virtual protected] QStringList QWebEnginePage::chooseFiles(QWebEnginePage::FileSelectionMode mode, const QStringList &oldFiles, const QStringList &acceptedMimeTypes)

Esta función es llamada cuando el contenido web solicita un nombre de archivo, por ejemplo como resultado de que el usuario haga clic en un botón de carga de archivos en un formulario HTML.

mode indica si se espera que se devuelva un solo archivo o varios.

Se puede proporcionar un nombre de archivo sugerido como primera entrada de oldFiles. acceptedMimeTypes es ignorado por la implementación por defecto, pero podría ser utilizado por anulaciones.

[virtual protected] QWebEnginePage *QWebEnginePage::createWindow(QWebEnginePage::WebWindowType type)

Esta función se llama para crear una nueva ventana del tamaño especificado en type. Por ejemplo, cuando un programa JavaScript solicita abrir un documento en una nueva ventana.

Si se puede crear la nueva ventana, se devuelve el QWebEnginePage de la nueva ventana; en caso contrario, se devuelve un puntero nulo.

Si la vista asociada a la página web es un objeto QWebEngineView, la implementación por defecto reenvía la petición a QWebEngineView::createWindow(); en caso contrario devuelve un puntero nulo.

Si esta llamada no está implementada o no devuelve una nueva página, se emite newWindowRequested() para gestionar la petición.

Véase también QWebEngineView::createWindow() y newWindowRequested().

[signal, since 6.7] void QWebEnginePage::desktopMediaRequested(const QWebEngineDesktopMediaRequest &request)

Esta señal se emite cuando una aplicación web solicita acceso al contenido de una pantalla.

El argumento request contiene referencias a modelos de datos de ventanas y pantallas disponibles para su captura. Para aceptar la solicitud, el controlador de la señal puede llamar a QWebEngineDesktopMediaRequest::selectScreen() o a QWebEngineDesktopMediaRequest::selectWindow().

Esta función se introdujo en Qt 6.7.

[since 6.6] QString QWebEnginePage::devToolsId() const

Devuelve el id del host de herramientas de desarrollo asociado a esta página.

Si la depuración remota está activada (consulte Qt WebEngine Developer Tools), el id se puede utilizar para construir la URL para conectarse al websocket de la herramienta de desarrollo: ws://localhost:<debugging-port>/devtools/page/<id>). El websocket puede utilizarse para interactuar con la página utilizando el protocolo DevTools.

Esta función se introdujo en Qt 6.6.

QWebEnginePage *QWebEnginePage::devToolsPage() const

Devuelve la página que aloja las herramientas para desarrolladores de esta página, si las hay.

Devuelve nullptr si no hay página de herramientas para desarrolladores.

Véase también setDevToolsPage() y inspectedPage().

void QWebEnginePage::download(const QUrl &url, const QString &filename = QString())

Descarga el recurso desde la ubicación indicada por url a un archivo local.

Si se indica filename, se utiliza como nombre de archivo sugerido. Si es relativo, el archivo se guarda en la ubicación de descarga estándar con el nombre dado. Si es nulo o vacío QString, se utiliza el nombre de archivo por defecto.

Esto emitirá QWebEngineProfile::downloadRequested() después de que la descarga haya comenzado.

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

Reimplementa: QObject::event(QEvent *e).

[signal, since 6.4] void QWebEnginePage::fileSystemAccessRequested(QWebEngineFileSystemAccessRequest request)

Esta señal se emite cuando la página web solicita acceso a archivos o directorios locales.

El objeto request request puede utilizarse para aceptar o rechazar la solicitud.

Esta función se introdujo en Qt 6.4.

[since 6.8] std::optional<QWebEngineFrame> QWebEnginePage::findFrameByName(QAnyStringView name)

Devuelve el marco con el nombre name. Si hay varios marcos con el mismo nombre, el que se devuelva es arbitrario. Si no se encuentra ningún marco, devuelve std::nullopt.

Esta función se introdujo en Qt 6.8.

void QWebEnginePage::findText(const QString &subString, QWebEnginePage::FindFlags options = {}, const std::function<void (const QWebEngineFindTextResult &)> &resultCallback = std::function<void(const QWebEngineFindTextResult &)>())

Busca la cadena especificada, subString, en la página, utilizando la dirección options. La señal findTextFinished() se emite cuando finaliza la búsqueda de una cadena.

Para borrar el resalte de búsqueda, basta con pasar una cadena vacía.

resultCallback debe recibir un parámetro QWebEngineFindTextResult.

Por ejemplo:

    m_view->page()->findText(QStringLiteral("Qt"), QWebEnginePage::FindFlags(), [this](const QWebEngineFindTextResult &result) {
        if (result.numberOfMatches() == 0) QMessageBox::information(m_view, QString(), QStringLiteral("No occurrences found"));
    });

Véase también findTextFinished().

[signal] void QWebEnginePage::findTextFinished(const QWebEngineFindTextResult &result)

Esta señal se emite cuando se completa una búsqueda de cadena en una página. result es el resultado de la búsqueda de cadena.

Véase también findText().

[signal] void QWebEnginePage::fullScreenRequested(QWebEngineFullScreenRequest fullScreenRequest)

Esta señal se emite cuando la página web emite la petición de entrar en modo de pantalla completa para un elemento web, normalmente un elemento de vídeo.

El objeto de solicitud fullScreenRequest puede utilizarse para aceptar o rechazar la solicitud.

Si la petición es aceptada, el elemento que solicita la pantalla completa llenará la ventana gráfica, pero depende de la aplicación hacer que la vista sea de pantalla completa o mover la página a una vista que sea de pantalla completa.

Véase también QWebEngineSettings::FullScreenSupportEnabled.

[signal] void QWebEnginePage::geometryChangeRequested(const QRect &geom)

Esta señal se emite siempre que el documento desea cambiar la posición y el tamaño de la página a geom. Esto puede ocurrir, por ejemplo, a través de JavaScript.

window->setGeometry(geom.marginsRemoved(window->frameMargins()));

QWebEngineHistory *QWebEnginePage::history() const

Devuelve un puntero al historial de páginas web navegadas de la vista.

[signal] void QWebEnginePage::iconChanged(const QIcon &icon)

Esta señal se emite cuando se cambia el icono ("favicon") asociado a la página. El nuevo icono se especifica en icon.

Véase también icon(), iconUrl(), y iconUrlChanged().

[signal] void QWebEnginePage::iconUrlChanged(const QUrl &url)

Esta señal se emite cuando se cambia la URL del icono ("favicon") asociado a la página. La nueva URL se especifica en url.

Véase también iconUrl(), icon(), y iconChanged().

QWebEnginePage *QWebEnginePage::inspectedPage() const

Devuelve la página que esta página está inspeccionando, si existe.

Devuelve nullptr si esta página no es una página de herramientas de desarrollo.

Véase también setInspectedPage() y devToolsPage().

[virtual protected] void QWebEnginePage::javaScriptAlert(const QUrl &securityOrigin, const QString &msg)

Esta función se llama siempre que un programa JavaScript que se ejecuta en un marco afiliado a securityOrigin llama a la función alert() con el mensaje msg.

La implementación por defecto muestra el mensaje, msg, con QMessageBox::information.

[virtual protected] bool QWebEnginePage::javaScriptConfirm(const QUrl &securityOrigin, const QString &msg)

Esta función es llamada cada vez que un programa JavaScript que se ejecuta en un marco afiliado a securityOrigin llama a la función confirm() con el mensaje msg. Devuelve true si el usuario confirma el mensaje; en caso contrario, devuelve false.

También se llama cuando el gestor de onbeforeunload solicita una confirmación antes de abandonar una página.

La implementación por defecto ejecuta la consulta utilizando QMessageBox::information con los botones QMessageBox::Ok y QMessageBox::Cancel.

[virtual protected] void QWebEnginePage::javaScriptConsoleMessage(QWebEnginePage::JavaScriptConsoleMessageLevel level, const QString &message, int lineNumber, const QString &sourceID)

Esta función se llama cuando un programa JavaScript intenta imprimir la dirección message en la consola del navegador web.

Por ejemplo, en caso de errores de evaluación, la URL de origen puede proporcionarse en sourceID, así como lineNumber.

level indica la gravedad del evento que desencadenó el mensaje. Es decir, si fue desencadenado por un error o por un evento menos grave.

La implementación por defecto registra los mensajes en un js logging category .

Véase también Registro en consola.

[virtual protected] bool QWebEnginePage::javaScriptPrompt(const QUrl &securityOrigin, const QString &msg, const QString &defaultValue, QString *result)

Esta función se ejecuta cada vez que un programa JavaScript que se ejecuta en un marco asociado a securityOrigin intenta pedir al usuario que introduzca datos. El programa puede proporcionar un mensaje opcional, msg, así como un valor predeterminado para la entrada en defaultValue.

Si el usuario cancela la solicitud, la implementación debe devolver false; de lo contrario, el resultado debe escribirse en result y debe devolverse true. Si el usuario no ha cancelado la consulta, la implementación debe devolver true y la cadena resultante no debe ser nula.

La implementación por defecto utiliza QInputDialog::getText().

[signal] void QWebEnginePage::linkHovered(const QString &url)

Esta señal se emite cuando el ratón pasa por encima de un enlace. url contiene la URL de destino del enlace.

void QWebEnginePage::load(const QUrl &url)

Carga url en esta página.

Véase también setUrl(), setHtml(), y setContent().

void QWebEnginePage::load(const QWebEngineHttpRequest &request)

Emite el request especificado y carga la respuesta.

Véase también load(), setUrl(), url(), urlChanged() y QUrl::fromUserInput().

[signal] void QWebEnginePage::loadFinished(bool ok)

Esta señal se emite cuando la página termina de cargar contenido. Esta señal es independiente de la ejecución del script o del renderizado de la página. ok indicará si la carga se ha realizado correctamente o si se ha producido algún error.

Véase también loadStarted() y acceptNavigationRequest().

[signal] void QWebEnginePage::loadProgress(int progress)

Esta señal se emite cuando cambia el estado de progreso global. El valor actual es proporcionado por progress y escala de 0 a 100, que es el rango por defecto de QProgressBar. Acumula los cambios de todos los fotogramas hijos.

[signal] void QWebEnginePage::loadStarted()

Esta señal se emite cuando una página comienza a cargar contenido.

Véase también loadFinished() y acceptNavigationRequest().

[signal, since 6.2] void QWebEnginePage::loadingChanged(const QWebEngineLoadingInfo &loadingInfo)

Esta señal se emite cuando la carga de la página especificada por loadingInfo comienza, termina o falla.

Esta función se introdujo en Qt 6.2.

[since 6.8] QWebEngineFrame QWebEnginePage::mainFrame()

El marco principal de la página. Todos los demás marcos de esta página son accesibles como hijos del marco principal.

Esta función se introdujo en Qt 6.8.

[signal, since 6.2] void QWebEnginePage::navigationRequested(QWebEngineNavigationRequest &request)

Esta señal se emite en la navegación junto con la llamada al acceptNavigationRequest(). Se puede utilizar para aceptar o ignorar la request. El valor predeterminado es aceptar.

Esta función se introdujo en Qt 6.2.

Véase también acceptNavigationRequest().

[signal, since 6.2] void QWebEnginePage::newWindowRequested(QWebEngineNewWindowRequest &request)

Esta señal se emite cuando se emite request para cargar una página en una ventana independiente del motor web. Esto puede ser porque la página actual lo solicitó explícitamente a través de una llamada JavaScript a window.open, o porque el usuario hizo clic en un enlace mientras mantenía pulsada la tecla Shift, Cmd/Ctrl, o una combinación incorporada que desencadena que la página se abra en una nueva ventana.

La señal se gestiona llamando a openIn() con la nueva página en la petición. Si no se gestiona esta señal, la carga solicitada fallará.

Esta función se introdujo en Qt 6.2.

Véase también createWindow() y QWebEngineNewWindowRequest::openIn().

[signal] void QWebEnginePage::pdfPrintingFinished(const QString &filePath, bool success)

Esta señal se emite cuando ha finalizado la impresión de la página web en un archivo PDF. filePath contendrá la ruta en la que se solicitó la creación del archivo, y success será true si el archivo se creó correctamente y false en caso contrario.

Véase también printToPdf().

[signal, since 6.8] void QWebEnginePage::permissionRequested(QWebEnginePermission permission)

Esta señal se emite cuando un sitio web solicita hacer uso de una funcionalidad (por ejemplo, acceso de geolocalización, permiso para enviar notificaciones). El objeto permission puede consultar la URL solicitante y el QWebEnginePermission::Feature que está pidiendo, así como conceder o denegar el permiso.

Esta función se introdujo en Qt 6.8.

[signal] void QWebEnginePage::printRequested()

Esta señal se emite cuando se llama al método JavaScript window.print() en el marco principal, o cuando el usuario pulsa el botón de impresión del complemento del visor de PDF. Normalmente, el controlador de la señal puede simplemente llamar a printToPdf().

Desde la versión 6.8, esta señal sólo se emite para el marco principal, en lugar de emitirse para cualquier marco que solicite la impresión.

Véase también printToPdf() y printRequestedByFrame().

[signal, since 6.8] void QWebEnginePage::printRequestedByFrame(QWebEngineFrame frame)

Esta señal se emite cuando se llama al método JavaScript window.print() en frame. Si el marco es el marco principal, se emite printRequested en su lugar.

Esta función se introdujo en Qt 6.8.

Véase también printRequested(), printToPdf(), y QWebEngineFrame::printToPdf().

void QWebEnginePage::printToPdf(const QString &filePath, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

Renderiza el contenido actual de la página en un documento PDF y lo guarda en la ubicación especificada en filePath. El tamaño de página y la orientación del documento PDF producido se toman de los valores especificados en layout, mientras que el rango de páginas impresas se toma de ranges siendo el valor por defecto imprimir todas las páginas.

Este método emite una petición asíncrona para imprimir la página web en un PDF y devuelve inmediatamente. Para conocer el resultado de la solicitud, conéctese a la señal pdfPrintingFinished().

Si ya existe un archivo en la ruta de archivo proporcionada, se sobrescribirá.

Véase también pdfPrintingFinished().

void QWebEnginePage::printToPdf(const std::function<void (const QByteArray &)> &resultCallback, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

Renderiza el contenido actual de la página en un documento PDF y devuelve una matriz de bytes que contiene los datos PDF como parámetro a resultCallback. El tamaño de página y la orientación del documento PDF producido se toman de los valores especificados en layout, mientras que el rango de páginas impresas se toma de ranges siendo el valor por defecto imprimir todas las páginas.

resultCallback debe tomar como parámetro una referencia constante a QByteArray. Si la impresión se ha realizado correctamente, esta matriz de bytes contendrá los datos del PDF; en caso contrario, la matriz de bytes estará vacía.

QWebEngineProfile *QWebEnginePage::profile() const

Devuelve el perfil del motor web al que pertenece la página.

[signal] void QWebEnginePage::proxyAuthenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator, const QString &proxyHost)

Esta señal se emite cuando el acceso a requestUrl a través de proxyHost requiere autenticación para el proxy. authenticator debe utilizarse para pasar el nombre de usuario y la contraseña para la conexión.

[signal] void QWebEnginePage::recentlyAudibleChanged(bool recentlyAudible)

Esta señal se emite cuando el estado audible de la página, recentlyAudible, cambia debido a la reproducción o detención del audio.

Si una página web contiene dos vídeos que se inician en secuencia, esta señal se emite sólo una vez para que el primer vídeo genere sonido. Una vez que ambos vídeos se detienen, la señal se emite al generarse el último sonido. Esto significa que la señal se emite tanto cuando se genera cualquier tipo de sonido como cuando todo está completamente en silencio dentro de una página web, independientemente del número de flujos de audio.

También pueden producirse emisiones espurias de señal. Por ejemplo, cuando el sonido se detiene, esta señal se emite primero con un valor de true, y después con un valor de false. Además, cuando el audio comienza a reproducirse, la señal se emite dos veces con un valor de true.

Véase también recentlyAudible.

[signal] void QWebEnginePage::registerProtocolHandlerRequested(QWebEngineRegisterProtocolHandlerRequest request)

Esta señal se emite cuando la página web intenta registrar un protocolo personalizado utilizando la API registerProtocolHandler.

El objeto de solicitud request se puede utilizar para aceptar o rechazar la solicitud:

void WebView::handleRegisterProtocolHandlerRequested(
        QWebEngineRegisterProtocolHandlerRequest request)
{
    auto answer = QMessageBox::question(window(), tr("Permission Request"),
                                        tr("Allow %1 to open all %2 links?")
                                                .arg(request.origin().host())
                                                .arg(request.scheme()));
    if (answer == QMessageBox::Yes)
        request.accept();
    else
        request.reject();
}

[signal] void QWebEnginePage::renderProcessPidChanged(qint64 pid)

Esta señal se emite cuando el PID del proceso de renderizado subyacente, pid, cambia.

[signal] void QWebEnginePage::renderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode)

Esta señal se emite cuando el proceso de renderizado finaliza con un estado de salida distinto de cero. terminationStatus es el estado de finalización del proceso y exitCode es el código de estado con el que finalizó el proceso.

void QWebEnginePage::replaceMisspelledWord(const QString &replacement)

Sustituya la palabra mal escrita actual por replacement.

La palabra mal escrita actual se puede encontrar en QWebEngineContextMenuRequest::misspelledWord(), y los reemplazos sugeridos en QWebEngineContextMenuRequest::spellCheckerSuggestions().

Ejecuta el código JavaScript contenido en scriptSource sin comprobar si se ha construido el DOM de la página. Si necesita más control sobre cómo se ejecuta el script, considere utilizar scripts() en su lugar.

Para evitar conflictos con otros scripts ejecutados en la página, el mundo en el que se ejecuta el script se especifica mediante worldId. Los valores de ID de mundo son los mismos que los proporcionados por QWebEngineScript::ScriptWorldId, y entre 0 y 256. Si omite el ID world, el script se ejecuta en MainWorld.

Cuando se ha ejecutado el script, se llama a resultCallback con el resultado de la última sentencia ejecutada. resultCallback puede ser cualquiera de los siguientes: un puntero de función, un functor o un lambda, y se espera que tome un parámetro QVariant. Por ejemplo:

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

Sólo los datos planos pueden ser devueltos desde JavaScript como valor de resultado. Los tipos de datos admitidos incluyen todos los tipos de datos JSON, así como, por ejemplo, Date y ArrayBuffer. Los tipos de datos no admitidos son, por ejemplo, Function y Promise.

Véase también scripts(), QWebEngineScript::ScriptWorldId, QWebEngineFrame::runJavaScript y Script Injection.

void QWebEnginePage::save(const QString &filePath, QWebEngineDownloadRequest::SavePageFormat format = QWebEngineDownloadRequest::MimeHtmlSaveFormat) const

Guarda en disco la página web cargada actualmente.

La página web se guarda en filePath en el format especificado.

Este es un atajo para las siguientes acciones:

• Activar la acción Guardar web.
• Aceptar el siguiente elemento de descarga y establecer la ruta de archivo y el formato de guardado especificados.

Esta función emite una solicitud de descarga asíncrona de la página web y la devuelve inmediatamente.

Véase también QWebEngineDownloadRequest::SavePageFormat.

QWebEngineScriptCollection &QWebEnginePage::scripts()

Devuelve la colección de scripts que se inyectan en la página.

Además, una página también puede ejecutar scripts añadidos a través de QWebEngineProfile::scripts().

Véase también QWebEngineScriptCollection, QWebEngineScript y Script Injection.

[signal] void QWebEnginePage::selectClientCertificate(QWebEngineClientCertificateSelection clientCertificateSelection)

Esta señal se emite cuando un sitio web solicita un certificado SSL de cliente, y se han encontrado uno o más en el almacén de certificados de cliente del sistema.

El manejo de la señal es asíncrono, y la carga esperará hasta que se seleccione un certificado, o se destruya la última copia de clientCertificateSelection.

Si no se gestiona la señal, clientCertificateSelection se destruirá automáticamente y la carga continuará sin un certificado de cliente.

Véase también QWebEngineClientCertificateSelection.

[signal] void QWebEnginePage::selectionChanged()

Esta señal se emite cada vez que cambia la selección, ya sea interactiva o programáticamente. Por ejemplo, llamando a triggerAction() con una acción de selección.

Véase también selectedText().

void QWebEnginePage::setContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl())

Establece el contenido de la página web en data. Si el argumento mimeType está vacío, se asume que el contenido es text/plain,charset=US-ASCII.

Los objetos externos a los que se hace referencia en el contenido se ubican en relación con baseUrl. Para que se carguen los objetos externos con URL relativas, baseUrl no puede estar vacío.

data se carga inmediatamente; los objetos externos se cargan de forma asíncrona.

Véase también toHtml() y setHtml().

void QWebEnginePage::setDevToolsPage(QWebEnginePage *devToolsPage)

Enlaza devToolsPage para ser las herramientas de desarrollador de esta página. Activa devToolsPage para navegar a una URL interna con las herramientas de desarrollo.

Esto es lo mismo que llamar a setInspectedPage() en devToolsPage con this como argumento.

Véase también devToolsPage() y setInspectedPage().

void QWebEnginePage::setHtml(const QString &html, const QUrl &baseUrl = QUrl())

Establece el contenido de esta página en html. baseUrl es opcional y se utiliza para resolver URL relativas en el documento, como imágenes u hojas de estilo referenciadas.

html se carga inmediatamente; los objetos externos se cargan de forma asíncrona.

Si una secuencia de comandos en html se ejecuta durante más tiempo que el tiempo de espera predeterminado para secuencias de comandos (actualmente 10 segundos), por ejemplo debido a que está bloqueada por un cuadro de diálogo modal de alerta de JavaScript, este método regresará tan pronto como sea posible después del tiempo de espera y cualquier html posterior se cargará de forma asíncrona.

Cuando se utiliza este método, el motor web asume que los recursos externos, como programas JavaScript u hojas de estilo, están codificados en UTF-8 a menos que se especifique lo contrario. Por ejemplo, la codificación de un script externo puede especificarse a través del atributo charset de la etiqueta script de HTML. También es posible que la codificación sea especificada por el servidor web.

Esta función es equivalente a setContent(html, "text/html", baseUrl).

Véase también toHtml(), setContent(), y load().

void QWebEnginePage::setInspectedPage(QWebEnginePage *page)

Navega esta página a una URL interna que son las herramientas de desarrollo de page.

Esto es lo mismo que llamar a setDevToolsPage() en page con this como argumento.

Véase también inspectedPage() y setDevToolsPage().

void QWebEnginePage::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

Registra el interceptor de peticiones interceptor para interceptar peticiones URL.

La página no se apropia del puntero. Este interceptor se llama después de cualquier interceptor en el perfil, y a diferencia de los interceptores de perfil, sólo se interceptan las peticiones URL de esta página. Si la petición original ya ha sido bloqueada o redirigida por el interceptor del perfil, no será interceptada por éste.

Para desactivar el interceptor de peticiones, escriba a nullptr.

Véase también QWebEngineUrlRequestInfo y QWebEngineProfile::setUrlRequestInterceptor().

void QWebEnginePage::setWebChannel(QWebChannel *channel, quint32 worldId = 0)

Establece la instancia del canal web que utilizará esta página en channel y la conecta al transporte del motor web utilizando mensajes IPC de Chromium. El transporte se expone en el mundo JavaScript worldId como qt.webChannelTransport, que debe utilizarse cuando se utiliza la API JavaScriptQt WebChannel .

Véase también webChannel() y QWebEngineScript::ScriptWorldId.

QWebEngineSettings *QWebEnginePage::settings() const

Devuelve un puntero al objeto de configuración de la página.

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

Esta señal se emite cada vez que cambia el título de la página. La cadena title especifica el nuevo título.

Véase también title().

void QWebEnginePage::toHtml(const std::function<void (const QString &)> &resultCallback) const

Método asíncrono para recuperar el contenido de la página como HTML, encerrado en etiquetas HTML y BODY. Una vez completado con éxito, se llama a resultCallback con el contenido de la página.

Véase también setHtml() y toPlainText().

void QWebEnginePage::toPlainText(const std::function<void (const QString &)> &resultCallback) const

Método asíncrono para recuperar el contenido de la página convertido a texto plano, completamente desprovisto de todo formato HTML. Una vez completado con éxito, se llama a resultCallback con el contenido de la página.

Véase también toHtml().

[virtual] void QWebEnginePage::triggerAction(QWebEnginePage::WebAction action, bool checked = false)

Esta función puede invocarse para activar la acción especificada en action. También es llamada por Qt WebEngine si el usuario activa la acción, por ejemplo a través de un elemento del menú contextual.

Si action es una acción controlable, entonces checked especifica si la acción es controlable o no.

Véase también action().

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

Esta señal se emite con la URL de la página cuando se recibe el título de la página. La nueva URL se especifica en url.

Véase también url().

[signal, since 6.7] void QWebEnginePage::webAuthUxRequested(QWebEngineWebAuthUxRequest *request)

Esta señal se emite cuando un autenticador WebAuth necesita la interacción del usuario durante el proceso de autenticación. Estas solicitudes se gestionan mostrando un cuadro de diálogo al usuario.

request contiene la información y la API necesarias para completar la solicitud WebAuth UX.

Esta función se introdujo en Qt 6.7.

Véase también QWebEngineWebAuthUxRequest.

QWebChannel *QWebEnginePage::webChannel() const

Devuelve un puntero a la instancia del canal web utilizado por esta página o un puntero nulo si no se ha establecido ninguno. Este canal utiliza automáticamente el mecanismo de transporte interno del motor web sobre Chromium IPC que se expone en el contexto JavaScript de esta página como qt.webChannelTransport.

Véase también setWebChannel().

[signal] void QWebEnginePage::windowCloseRequested()

Esta señal se emite cada vez que la página solicita que se cierre la ventana del navegador web, por ejemplo a través de la llamada a JavaScript window.close().

Véase también RequestClose.

[signal, since 6.8] void QWebEnginePage::zoomFactorChanged(qreal factor)

Esta señal se emite cada vez que cambia el zoom factor de la página.

Esta función se introdujo en Qt 6.8.

Véase también zoomFactor() y setZoomFactor().