En esta página

Qt WebEngine QML Types

Para enlazar con el módulo usando qmake, añada la siguiente variable QT a su archivo qmake .pro:

QT += webenginequick

Para compilar con CMake utilice el comando find_package() para localizar los componentes del módulo necesarios en el paquete Qt6 y target_link_libraries() para enlazar con el módulo:

find_package(Qt6 REQUIRED COMPONENTS WebEngineQuick)
target_link_libraries(target PRIVATE Qt6::WebEngineQuick)

La mínima cantidad de código necesaria para cargar y mostrar una página HTML utilizando el motor QML requiere una inicialización adecuada:

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QtWebEngineQuick/qtwebenginequickglobal.h>

int main(int argc, char *argv[])
{
    QCoreApplication::setAttribute(Qt::AA_ShareOpenGLContexts);
    QtWebEngineQuick::initialize();
    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Donde el contenido de main.qml es simplemente:

import QtQuick
import QtQuick.Window
import QtWebEngine

Window {
    width: 1024
    height: 750
    visible: true
    WebEngineView {
        anchors.fill: parent
        url: "https://www.qt.io"
    }
}

Tipos de objetos QML

AuthenticationDialogRequest

Una solicitud para proporcionar credenciales de autenticación requeridas por proxies o servidores HTTP

ColorDialogRequest

Una solicitud para que el usuario seleccione un color

ContextMenuRequest

Una petición para mostrar un menú contextual

FileDialogRequest

Una solicitud para que el usuario elija un archivo o directorio (nuevo o existente)

JavaScriptDialogRequest

Una solicitud para mostrar una alerta, una confirmación o un diálogo de aviso desde JavaScript al usuario.

TooltipRequest

Una petición para mostrar un tooltip al usuario

TouchSelectionMenuRequest

Una solicitud para mostrar un menú de selección táctil

WebEngine

Proporciona acceso a la configuración predeterminada y a los perfiles compartidos por todas las vistas del motor web

WebEngineAction

Una acción que representa una WebEngineView::WebAction

WebEngineClientCertificateOption

Representa una opción de certificado de cliente

WebEngineClientCertificateSelection

Proporciona una selección de certificados de cliente

WebEngineDownloadRequest

Proporciona información sobre una descarga

WebEngineHistory

Proporciona modelos de datos que representan el historial de una página del motor web

WebEngineHistoryModel

Modelo de datos que representa el historial de una página del motor web

WebEngineNavigationRequest

Representa una solicitud de navegación a una página web como parte de WebEngineView::navigationRequested()

WebEngineNewWindowRequest

Un tipo de utilidad para la señal WebEngineView::newWindowRequested

WebEngineNotification

Encapsula los datos de una notificación web HTML5

WebEngineProfile

Contiene configuraciones, scripts y enlaces visitados comunes a múltiples vistas del motor web

WebEngineProfilePrototype

Crea una instancia de la clase QQuickWebEngineProfile

WebEngineScriptCollection

Gestiona una colección de scripts de usuario

WebEngineSettings

Permite la configuración de propiedades y atributos del navegador

WebEngineView

Una WebEngineView renderiza contenido web dentro de una aplicación QML

WebEngineWebAuthUxRequest

Encapsula los datos de una solicitud WebAuth UX

Tipos de valores QML

findTextResult

Un tipo de utilidad para encapsular el resultado de una búsqueda de cadenas en una página

fullScreenRequest

Un tipo de utilidad para la señal WebEngineView::fullScreenRequested()

registerProtocolHandlerRequest

Un tipo permite aceptar o rechazar solicitudes de la API registerProtocolHandler

webEngineCertificateError

Un tipo de utilidad para ignorar errores de certificado o rechazar certificados erróneos

webEngineDesktopMediaRequest

Una solicitud para rellenar un cuadro de diálogo con las fuentes disponibles para la captura de pantalla

webEngineFrame

Información y control sobre un marco de página

webEngineLoadingInfo

Un tipo de utilidad para la señal WebEngineView::loadingChanged

webEnginePermission

Un objeto utilizado para acceder y modificar el estado de un permiso único que se ha concedido o denegado a una URL de origen específica

webEngineScript

Permite la inyección programática de scripts en el motor JavaScript

webEngineWebAuthPinRequest

Encapsula los datos de una solicitud PIN WebAuth UX

© 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.