Sur cette page

Qt WebEngine QML Types

Pour établir un lien avec le module en utilisant la compilation avec qmake, ajoutez la variable QT suivante à votre fichier qmake .pro :

QT += webenginequick

Pour la compilation avec CMake, utilisez la commande find_package() pour localiser les composants nécessaires du module dans le paquetage Qt6 et target_link_libraries() pour établir un lien avec le module :

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

La quantité minimale de code nécessaire pour charger et afficher une page HTML à l'aide du moteur QML nécessite une initialisation correcte :

#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();
}

Où le contenu de main.qml est simplement :

import QtQuick
import QtQuick.Window
import QtWebEngine

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

Types d'objets QML

AuthenticationDialogRequest

Une requête pour fournir les informations d'authentification requises par les proxys ou les serveurs HTTP

ColorDialogRequest

Une demande de sélection d'une couleur par l'utilisateur

ContextMenuRequest

Une demande d'affichage d'un menu contextuel

FileDialogRequest

Une demande permettant à l'utilisateur de choisir un fichier ou un répertoire (nouveau ou existant)

JavaScriptDialogRequest

Demande d'affichage d'une alerte, d'une confirmation ou d'une boîte de dialogue à partir de JavaScript pour l'utilisateur.

TooltipRequest

Demande d'affichage d'une infobulle à l'intention de l'utilisateur

TouchSelectionMenuRequest

Une demande d'affichage d'un menu de sélection tactile

WebEngine

Permet d'accéder aux paramètres et profils par défaut partagés par toutes les vues du moteur web.

WebEngineAction

Une action qui représente une WebEngineView::WebAction

WebEngineClientCertificateOption

Représente une option de certificat client

WebEngineClientCertificateSelection

Fournit une sélection de certificats clients

WebEngineDownloadRequest

Fournit des informations sur un téléchargement

WebEngineHistory

Fournit des modèles de données qui représentent l'historique d'une page de moteur web

WebEngineHistoryModel

Modèle de données représentant l'historique d'une page de moteur web

WebEngineNavigationRequest

Représente une demande de navigation vers une page web dans le cadre de WebEngineView::navigationRequested()

WebEngineNewWindowRequest

Un type d'utilité pour le signal WebEngineView::newWindowRequested

WebEngineNotification

Encapsule les données d'une notification web HTML5

WebEngineProfile

Contient des paramètres, des scripts et des liens visités communs à plusieurs vues de moteur Web

WebEngineProfilePrototype

Crée une instance de la classe QQuickWebEngineProfile

WebEngineScriptCollection

Gère une collection de scripts utilisateur

WebEngineSettings

Permet de configurer les propriétés et les attributs du navigateur

WebEngineView

Une WebEngineView assure le rendu du contenu web dans une application QML.

WebEngineWebAuthUxRequest

Encapsule les données d'une requête WebAuth UX

Types de valeurs QML

findTextResult

Un type d'utilité pour encapsuler le résultat d'une recherche de chaîne de caractères sur une page

fullScreenRequest

Un type d'utilité pour le signal WebEngineView::fullScreenRequested()

registerProtocolHandlerRequest

Type permettant d'accepter ou de rejeter les demandes de l'API registerProtocolHandler

webEngineCertificateError

Un type d'utilitaire pour ignorer les erreurs de certificat ou rejeter les certificats erronés

webEngineDesktopMediaRequest

Demande de remplissage d'une boîte de dialogue avec les sources disponibles pour la capture d'écran

webEngineFrame

Informations et contrôle sur un cadre de page

webEngineLoadingInfo

Un type d'utilitaire pour le signal WebEngineView::loadingChanged

webEnginePermission

Un objet utilisé pour accéder et modifier l'état d'une autorisation unique qui a été accordée ou refusée à une URL d'origine spécifique.

webEngineScript

Permet l'injection programmatique de scripts dans le moteur JavaScript

webEngineWebAuthPinRequest

Encapsule les données d'une requête 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.