Qt WebEngine QML Types

qmake로 빌드를 사용하여 모듈에 링크하려면 qmake .pro 파일에 다음 QT 변수를 추가합니다:

QT += webenginequick

CMake로 빌드할 경우 find_package() 명령을 사용하여 Qt6 패키지에서 필요한 모듈 구성 요소를 찾고 target_link_libraries() 명령을 사용하여 모듈에 링크합니다:

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

QML 엔진을 사용하여 HTML 페이지를 로드하고 표시하는 데 필요한 최소한의 코드는 적절한 초기화가 필요합니다:

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

여기서 main.qml의 내용은 간단합니다:

import QtQuick
import QtQuick.Window
import QtWebEngine

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

QML 객체 유형

AuthenticationDialogRequest

프록시 또는 HTTP 서버에 필요한 인증 자격 증명 제공 요청

ColorDialogRequest

사용자에 의한 색상 선택 요청

ContextMenuRequest

컨텍스트 메뉴를 표시하기 위한 요청

FileDialogRequest

사용자가 (새 파일 또는 기존) 파일 또는 디렉터리를 선택하도록 하는 요청

FindTextResult

페이지에서 문자열 검색 결과를 캡슐화하기 위한 유틸리티 유형

FullScreenRequest

WebEngineView::fullScreenRequested() 신호용 유틸리티 유형

JavaScriptDialogRequest

자바스크립트 내에서 사용자에게 경고, 확인 또는 프롬프트 대화 상자를 표시하기 위한 요청입니다.

RegisterProtocolHandlerRequest

등록 프로토콜 핸들러 API의 요청을 수락하거나 거부할 수 있는 유형입니다.

TooltipRequest

사용자에게 툴팁을 표시하기 위한 요청

TouchSelectionMenuRequest

터치 선택 메뉴 표시 요청

WebEngine

모든 웹 엔진 보기에서 공유되는 기본 설정 및 프로필에 대한 액세스를 제공합니다.

WebEngineAction

WebEngineView::WebAction을 나타내는 액션

WebEngineCertificateError

인증서 오류를 무시하거나 잘못된 인증서를 거부하기 위한 유틸리티 유형

WebEngineClientCertificateOption

클라이언트 인증서 옵션을 나타냅니다.

WebEngineClientCertificateSelection

클라이언트 인증서 선택 제공

WebEngineDesktopMediaRequest

화면 캡처에 사용 가능한 소스로 대화 상자를 채우기 위한 요청입니다.

WebEngineDownloadRequest

다운로드에 대한 정보 제공

WebEngineHistory

웹 엔진 페이지의 이력을 나타내는 데이터 모델을 제공합니다.

WebEngineHistoryModel

웹 엔진 페이지의 이력을 나타내는 데이터 모델

WebEngineLoadingInfo

WebEngineView::loadingChanged 신호에 대한 유틸리티 유형

WebEngineNavigationRequest

WebEngineView::navigationRequested()의 일부로 웹 페이지로 이동하기 위한 요청을 나타냅니다.

WebEngineNewWindowRequest

WebEngineView::newWindowRequested 신호에 대한 유틸리티 유형입니다.

WebEngineNotification

HTML5 웹 알림의 데이터를 캡슐화합니다.

WebEngineProfile

여러 웹 엔진 뷰에 공통된 설정, 스크립트 및 방문한 링크를 포함합니다.

WebEngineScript

자바스크립트 엔진에서 스크립트를 프로그래밍 방식으로 삽입할 수 있습니다.

WebEngineScriptCollection

사용자 스크립트 모음 관리

WebEngineSettings

브라우저 속성 및 속성을 구성할 수 있습니다.

WebEngineView

웹엔진뷰는 QML 애플리케이션 내에서 웹 콘텐츠를 렌더링합니다.

WebEngineWebAuthUxRequest

WebAuth UX 요청의 데이터를 캡슐화합니다.

QML 값 유형

webEngineFrame

페이지 프레임에 대한 정보 및 제어

webEnginePermission

특정 원본 URL에 부여되거나 거부된 단일 권한의 상태에 액세스하고 수정하는 데 사용되는 객체

webEngineWebAuthPinRequest

PIN WebAuth UX 요청의 데이터를 캡슐화합니다.

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