Qt WebEngine QML 类型

要链接到采用 qmake 构建的模块,添加以下 QT 变量到 qmake .pro 文件:

QT += webenginequick
					

为采用 CMake 构建,使用 find_package() 命令以定位 Qt6 包中需要的模块组件和 target_link_libraries() 以链接到模块:

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

The minimal amount of code needed to load and display an HTML page using the QML engine requires a proper initialization:

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

Where the content of main.qml is simply:

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

AuthenticationDialogRequest

A request for providing authentication credentials required by proxies or HTTP servers

ColorDialogRequest

用于通过用户选择颜色的请求

ContextMenuRequest

用于展示上下文菜单的请求

FileDialogRequest

A request for letting the user choose a (new or existing) file or directory

FindTextResult

A utility type for encapsulating the result of a string search on a page

FullScreenRequest

A utility type for the WebEngineView::fullScreenRequested() signal

JavaScriptDialogRequest

A request for showing an alert, a confirmation, or a prompt dialog from within JavaScript to the user

RegisterProtocolHandlerRequest

Type enables accepting or rejecting requests from the registerProtocolHandler API

TooltipRequest

A request for showing a tooltip to the user

TouchSelectionMenuRequest

A request for showing a touch selection menu

WebEngine

Provides access to the default settings and profiles shared by all web engine views

WebEngineAction

An action that represents a WebEngineView::WebAction

WebEngineCertificateError

A utility type for ignoring certificate errors or rejecting erroneous certificates

WebEngineClientCertificateOption

Represents a client certificate option

WebEngineClientCertificateSelection

Provides a selection of client certificates

WebEngineDownloadRequest

提供关于下载的信息

WebEngineHistory

Provides data models that represent the history of a web engine page

WebEngineHistoryModel

A data model that represents the history of a web engine page

WebEngineLoadingInfo

A utility type for the WebEngineView::loadingChanged signal

WebEngineNavigationRequest

Represents a request for navigating to a web page as part of WebEngineView::navigationRequested()

WebEngineNewWindowRequest

A utility type for the WebEngineView::newWindowRequested signal

WebEngineNotification

封装 HTML5 Web 通知数据

WebEngineProfile

Contains settings, scripts, and visited links common to multiple web engine views

WebEngineScript

Enables the programmatic injection of scripts in the JavaScript engine

WebEngineScriptCollection

Manages a collection of user scripts

WebEngineSettings

Allows configuration of browser properties and attributes

WebEngineView

A WebEngineView renders web content within a QML application