WebEngineView QML Type

다양한 상위 수준 오류 유형을 설명합니다:

findText() 함수에서 사용할 수 있는 옵션에 대해 설명합니다. 옵션은 다음 목록에서 OR로 조합할 수 있습니다:

findText()도 참조하세요 .

JavaScript 콘솔 메시지의 심각도를 나타냅니다:

이 열거형은 페이지의 수명 주기 상태를 설명합니다:

이 프로퍼티는 QtWebEngine 1.10에 도입되었습니다.

lifecycleState, 페이지 라이프사이클 API 및 웹엔진 라이프사이클 예시를참조하세요 .

페이지의 로드 상태를 반영합니다:

WebEngineView 의 콘텐츠로부터 생성되는 PDF 문서의 방향을 설명합니다. 열거 값은 QPageLayout::Orientation 에서 매핑되며 반드시 일치해야 합니다.

이 속성은 QtWebEngine 1.3에 도입되었습니다.

WebEngineView::printToPdf()도 참조하십시오 .

이 열거형 유형은 포스트스크립트 PPD 표준에 정의된 대로 사용 가능한 페이지 크기를 나열합니다.

열거형 값은 QPageSize::PageSizeId 에서 매핑되며 반드시 일치해야 합니다. QPagedPaintDevice 및 QPrinter 에도 중복됩니다.

정의된 크기는 다음과 같습니다:

이 프로퍼티는 QtWebEngine 1.3에 도입되었습니다.

WebEngineView::printToPdf()도 참조하십시오 .

렌더링 프로세스가 종료된 상태를 설명합니다:

이 속성은 QtWebEngine 1.2에 도입되었습니다.

웹 페이지에서 수행할 수 있는 작업 유형을 설명합니다:

이 프로퍼티는 QtWebEngine 1.2에 도입되었습니다.

뷰를 눌렀을 때 활성 포커스를 가져올지 여부를 지정합니다. 기본값은 true 입니다.

이 프로퍼티는 QtWebEngine 1.2에 도입되었습니다.

현재 페이지 오디오가 음소거되었는지 여부의 상태입니다.

이 속성은 QtWebEngine 1.3에 도입되었습니다.

recentlyAudible 를참조하십시오 .

문서 본문 뒤에 있는 WebEngineView 의 배경 색상을 변경합니다. "transparent" 또는 반투명 색상으로 설정하여 문서를 통해 보이도록 하거나 하이브리드 앱의 웹 콘텐츠와 일치하도록 하여 로드 중에 나타날 수 있는 흰색 깜박임을 방지할 수 있습니다.

기본값은 흰색입니다.

이 속성은 QtWebEngine 1.2에 도입되었습니다.

이전 세션 기록 항목이 있는 경우 true, 그렇지 않은 경우 false 을 반환합니다.

후속 세션 기록 항목이 있으면 true, 그렇지 않으면 false 을 반환합니다.

페이지 콘텐츠의 크기.

이 프로퍼티는 QtWebEngine 1.3에 도입되었습니다.

이 페이지와 연관된 개발자 도구 호스트의 ID.

원격 디버깅이 활성화된 경우( Qt WebEngine 개발자 도구 참조), 이 ID를 사용하여 개발자 도구 웹소켓에 연결할 URL을 작성할 수 있습니다: ws://localhost:<debugggin-port>/devtools/page/<id>). 웹소켓은 개발자 도구 프로토콜을 사용하여 페이지와 상호 작용하는 데 사용할 수 있습니다.

이 속성은 QtWebEngine 6.6에 도입되었습니다.

현재 이 뷰에 대한 개발자 도구를 호스팅하는 뷰입니다. 새 보기로 설정하면 해당 보기가 개발자 도구가 있는 내부 URL로 이동하고 이 보기에 바인딩됩니다.

이 속성은 QtWebEngine 1.7에 도입되었습니다.

inspectedView 를참조하십시오 .

현재 뷰의 탐색 기록.

이 속성은 QtWebEngine 1.1에 도입되었습니다.

WebEngineHistory 를참조하십시오 .

현재 표시된 웹 사이트 아이콘(파비콘 또는 바로 가기 아이콘이라고도 함)에 액세스하기 위한 내부 URL입니다. 이 읽기 전용 URL은 모바일 브라우저 애플리케이션 내에서 기기의 홈 화면에서 북마크된 페이지를 나타내는 데 사용되는 이미지에 해당합니다.

다음 코드 조각은 icon 속성을 사용하여 Image 컴포넌트를 빌드합니다:

Image {
    id: appIcon
    sourceSize: Qt.size(32, 32)
    source: webView.icon != "" ? webView.icon : "fallbackFavicon.png";
    // ...
}

Image::sourceSize 속성을 지정하면 Qt WebEngine 의 파비콘 제공업체에 요청된 크기를 알리고 아이콘의 크기를 해당 크기로 조정합니다. Image::sourceSize 속성을 지정하지 않으면 공급자는 사용 가능한 가장 큰 해상도로 아이콘을 제공합니다.

이 뷰가 현재 검사 중인 뷰(있는 경우)입니다. 이 속성을 설정하면 뷰 집합의 개발자 도구가 있는 내부 URL로 이동합니다.

개발자 도구가 표시되지 않을 때는 이 속성을 해제하는 것이 좋습니다. 그렇지 않으면 검사된 WebEngineView 에 일부 디버그 정보가 표시될 수 있습니다.

이 속성은 QtWebEngine 1.7에 도입되었습니다.

devToolsView 를참조하십시오 .

웹 보기가 전체 화면 모드인 경우 true, 그렇지 않으면 false 을 반환합니다.

이 프로퍼티는 QtWebEngine 1.1에 도입되었습니다.

fullScreenRequested() 및 fullScreenCancelled()도 참조하십시오 .

페이지의 현재 라이프사이클 상태입니다.

설정자에 의해 다음과 같은 제한이 적용됩니다:

• 표시되는 페이지는 Active 상태를 유지해야 합니다.
• devToolsView 에서 페이지를 검사하는 경우 두 페이지 모두 Active 상태를 유지해야 합니다.
• Discarded 상태의 페이지는 Active 상태로만 전환할 수 있습니다. 그러면 페이지가 다시 로드됩니다.

이는 수명 주기 상태에 대한 유일한 하드 제한이지만 권장되는 소프트 제한에 대해서는 recommendedState 을 참조하세요.

이 속성은 QtWebEngine 1.10에 도입되었습니다.

recommendedState, 페이지 라이프사이클 API 및 WebEngine 라이프사이클 예제도참조하세요 .

로드된 페이지의 데이터 양으로, 0 ~ 100 범위의 정수 백분율로 표현됩니다.

HTML 페이지가 현재 로드 중이면 true, 그렇지 않으면 false 을 반환합니다.

페이지의 최상위 기본 프레임입니다. 이 페이지의 다른 모든 프레임은 메인 프레임의 하위 프레임으로 액세스할 수 있습니다.

이 프로퍼티는 QtWebEngine 6.8에 도입되었습니다.

뷰에 사용된 현재 프로파일입니다.

이 속성은 QtWebEngine 1.1에 도입되었습니다.

WebEngineProfile 를참조하십시오 .

현재 페이지의 가청 상태(오디오가 최근에 재생되었는지 여부)를 반환합니다.

이 속성은 QtWebEngine 1.3에 도입되었습니다.

audioMuted 및 recentlyAudibleChanged 를참조하십시오 .

페이지의 수명 주기 상태에 대한 권장 제한입니다.

수명 주기 상태를 권장 상태보다 낮은 리소스 사용량 상태로 설정하면 백그라운드 오디오 재생이 중지되거나 HTML 양식 입력이 손실되는 등의 부작용이 발생할 수 있습니다. 그러나 수명 주기 상태를 더 높은 리소스 상태로 설정하면 완전히 안전합니다.

이 속성은 QtWebEngine 1.10에 도입되었습니다.

lifecycleState, 페이지 라이프사이클 API 및 웹엔진 라이프사이클 예제를참조하세요 .

현재 페이지의 메인 프레임에 할당된 렌더링 프로세스의 프로세스 ID(PID)를 반환합니다.

아직 사용할 수 있는 렌더링 프로세스가 없는 경우 0 가 반환됩니다.

이 프로퍼티는 QtWebEngine 1.11에 도입되었습니다.

renderProcessPidChanged 를참조하십시오 .

페이지 콘텐츠의 스크롤 위치.

이 속성은 QtWebEngine 1.3에 도입되었습니다.

이 뷰에서 사용하는 설정.

이 속성은 QtWebEngine 1.1에 도입되었습니다.

WebEngineSettings 를참조하십시오 .

현재 표시된 HTML 페이지의 제목입니다. <title> 태그의 내용을 반영하는 읽기 전용 값입니다.

touchHandleDelegate 은 터치 선택 처리가 필요할 때마다 뷰에 의해 인스턴스화된 시각적 터치 핸들을 정의하는 템플릿을 제공합니다.

핸들의 위치, 불투명도 및 가시성은 자동으로 업데이트됩니다. 델리게이트는 QML 항목 또는 이를 상속하는 QML 유형이어야 합니다.

다음 코드는 사용자 지정 터치 핸들 델리게이트를 사용합니다:

WebEngineView {
// ...
    touchHandleDelegate: Rectangle {
        color: "red"
    }
    // ...
}

터치 핸들은 동적으로 전환할 수도 있습니다:

 Component {
    id: circleTouchHandle
    Rectangle {
        color: "blue"
        radius: 50
    }
}
function showDefaultHandle(isDefault) {
    if (isDefault)
        webEngineView.touchHandleDelegate = circleTouchHandle
    else
        webEngineView.touchHandleDelegate = null
}

이 속성은 QtWebEngine 6.4에 도입되었습니다.

현재 표시된 HTML 페이지의 위치입니다. 이 쓰기 가능한 속성은 웹 뷰에 페이지를 로드하는 기본 인터페이스를 제공합니다. window.location DOM 속성과 동일한 기능을 합니다.

loadHtml()도 참조하세요 .

뷰와 연결된 사용자 스크립트 컬렉션입니다.

이 속성은 QtWebEngine 1.1에 도입되었습니다.

WebEngineScriptCollection 를참조하십시오 .

이 뷰에서 사용하는 웹 채널 인스턴스입니다. 이 채널은 자동으로 Chromium IPC를 통해 내부 QtWebEngine 전송 메커니즘을 사용하며, 렌더링되는 페이지의 자바스크립트 컨텍스트에 qt.webChannelTransport 로 노출됩니다. 이 전송 객체는 Qt WebChannel JavaScript API를 사용하여 QWebChannel 의 JavaScript 대응 객체를 인스턴스화할 때 사용됩니다.

이 속성은 QtWebEngine 1.1에 도입되었습니다.

이 뷰에서 사용하는 웹 채널 인스턴스가 설치된 자바스크립트 월드입니다. 월드는 0 에서 256 사이의 숫자여야 합니다.

이 속성은 QtWebEngine 1.3에 도입되었습니다.

뷰의 확대/축소 계수. 유효한 값은 0.25 에서 5.0 범위 내에 있습니다. 기본값은 1.0 입니다.

이 속성은 QtWebEngine 1.1에 도입되었습니다.

이 신호는 activeFocusOnPress 값이 변경될 때 발생합니다. 이 신호는 뷰를 눌렀을 때 뷰에 활성 포커스를 적용할지 여부를 지정합니다.

이 신호는 QtWebEngine 1.2에 도입되었습니다.

activeFocusOnPress 및 setActiveFocusOnPress()도 참조하세요 .

이 신호는 muted 값이 변경될 때 발생합니다. 값은 audioMuted 속성을 사용하여 지정합니다.

이 신호는 QtWebEngine 1.3에 도입되었습니다.

audioMuted 및 recentlyAudibleChanged 을참조하세요 .

이 신호는 인증 대화 상자가 요청될 때 전송됩니다.

request 는 AuthenticationDialogRequest 유형의 메서드를 사용하여 처리할 수 있습니다.

이 시그널은 QtWebEngine 1.4에 도입되었습니다.

이 신호는 웹 엔진 보기 배경색이 변경될 때 발생합니다.

이 신호는 QtWebEngine 1.2에 도입되었습니다.

이 신호는 지정된 요청을 로드하는 동안 잘못된 인증서 오류( error)가 발생할 때 발생합니다.

인증서 오류는 WebEngineCertificateError 유형의 메서드를 사용하여 처리할 수 있습니다.

이 신호는 QtWebEngine 1.1에 도입되었습니다.

이 신호는 색상 선택기 대화 상자가 요청될 때 전송됩니다.

request 는 ColorDialogRequest 유형의 메서드를 사용하여 처리할 수 있습니다.

이 시그널은 QtWebEngine 1.4에 도입되었습니다.

이 신호는 컨텍스트 메뉴가 요청될 때 발생합니다.

request 는 ContextMenuRequest 유형의 속성을 사용하여 처리할 수 있습니다.

이 신호는 QtWebEngine 1.4에 도입되었습니다.

이 신호는 웹 애플리케이션이 디스플레이 콘텐츠에 대한 액세스를 요청할 때 발생합니다.

request 인수는 캡처할 수 있는 창 및 화면에 대한 데이터 모델에 대한 참조를 포함합니다. 요청을 수락하기 위해 신호 처리기는 WebEngineDesktopMediaRequest::selectScreen() 또는 WebEngineDesktopMediaRequest::selectWindow()을 호출할 수 있습니다.

이 신호는 QtWebEngine 6.7에 도입되었습니다.

이 신호는 파일 선택기 대화 상자가 요청될 때 전송됩니다.

request 는 FileDialogRequest 유형의 메서드를 사용하여 처리할 수 있습니다.

이 시그널은 QtWebEngine 1.4에 도입되었습니다.

이 신호는 페이지에서 문자열 검색이 완료될 때 발생합니다. result 은 문자열 검색의 결과입니다.

이 신호는 QtWebEngine 1.10에 도입되었습니다.

findText() 및 FindTextResult 을참조하십시오 .

이 신호는 웹 페이지가 JavaScript API를 통해 전체 화면 모드를 위해 request 를 발행할 때 발생합니다.

이 신호는 QtWebEngine 1.1에 도입되었습니다.

isFullScreen 를참조하십시오 .

이 신호는 문서에서 페이지의 위치와 크기를 frameGeometry 로 변경하려고 할 때마다 발생하며, 예를 들어 JavaScript를 통해 발생할 수 있습니다.

frameGeometry 에는 프레임 여백 크기가 포함되지만 geometry 에는 프레임 여백 크기가 제외됩니다.

onGeometryChangeRequested: {
    window.x = geometry.x
    window.y = geometry.y
    window.width = geometry.width
    window.height = geometry.height
}

이 신호는 QtWebEngine 1.7에 도입되었습니다.

이 신호는 자바스크립트 프로그램이 웹 브라우저의 콘솔에 message 을 출력하려고 할 때 발생합니다.

예를 들어, 평가 오류의 경우 소스 URL은 sourceID 뿐만 아니라 lineNumber 으로도 제공될 수 있습니다.

level 는 메시지를 트리거한 이벤트의 심각도, 즉 오류에 의해 트리거되었는지 아니면 덜 심각한 이벤트에 의해 트리거되었는지를 나타냅니다.

처리기를 지정하지 않으면 뷰에서 메시지를 js logging category 에 기록합니다.

콘솔 로깅도참조하세요 .

이 신호는 자바스크립트 대화 상자가 요청될 때 발생합니다.

request 는 JavaScriptDialogRequest 유형의 메서드를 사용하여 처리할 수 있습니다.

이 시그널은 QtWebEngine 1.4에 도입되었습니다.

마우스 기반 인터페이스에서 이 신호는 마우스 포인터가 링크 위를 지나갈 때 발생하며 mouseover DOM 이벤트에 해당합니다. 이 이벤트는 preventDefault() 으로 취소되지 않은 mouseover 이벤트에 대한 터치 인터페이스에서도 발생할 수 있습니다. hoveredUrl 은 링크의 위치를 제공합니다.

이 신호는 페이지 로드가 시작, 종료 또는 실패할 때 발생합니다.

onLoadingChanged 로 신호를 처리하는 경우 loadingInfo 에서 지정한 WebEngineLoadingInfo 에서 다양한 읽기 전용 매개 변수를 사용할 수 있습니다.

loading, LoadStatus, ErrorDomain도 참조하세요 .

이 신호는 내비게이션 요청 request 이 발행될 때 전송됩니다.

이 신호는 별도의 웹 엔진 보기에서 페이지를 로드하기 위해 request 을 실행할 때 발생합니다. 이는 현재 페이지에서 window.open 에 대한 자바스크립트 호출을 통해 명시적으로 요청했거나 사용자가 Shift, Ctrl 또는 기본 제공 조합을 누른 상태에서 링크를 클릭하여 페이지가 새 창에서 열리게 되었기 때문일 수 있습니다.

이 신호는 대상 보기에서 acceptAsNewWindow()를 호출하여 처리됩니다. 이 신호가 처리되지 않으면 요청된 로드가 실패합니다.

구현 예시입니다:

QtObject {
    id: windowParent
    // Create the initial browsing windows and open the startup page.
    Component.onCompleted: {
        var firstWindow = windowComponent.createObject(windowParent);
        firstWindow.webView.loadHtml('<input type="button" value="Click!" onclick="window.open(&quot;http://qt.io&quot;)">');
    }

    property Component windowComponent: Window {
        // Destroy on close to release the Window's QML resources.
        // Because it was created with a parent, it won't be garbage-collected.
        onClosing: destroy()
        visible: true

        property WebEngineView webView: webView_
        WebEngineView {
            id: webView_
            anchors.fill: parent

            // Handle the signal. Dynamically create the window and
            // use its WebEngineView as the destination of our request.
            onNewWindowRequested: function(request) {
                var newWindow = windowComponent.createObject(windowParent);
                newWindow.webView.acceptAsNewWindow(request);
            }
        }
    }
}

이 신호는 QtWebEngine 2.0에 도입되었습니다.

WebEngineNewWindowRequest 및 웹엔진 퀵 나노 브라우저를참조하세요 .

이 신호는 웹 페이지를 PDF 파일로 인쇄가 완료되었을 때 발생합니다. filePath 에는 파일 생성을 요청받은 경로가 포함되며, success 은 파일이 성공적으로 생성된 경우 true, 그렇지 않은 경우 false 이 됩니다.

이 신호는 QtWebEngine 1.5에 도입되었습니다.

printToPdf()도 참조하세요 .

이 신호는 웹 사이트에서 권한 요청(예: 지리적 위치 액세스, 알림 전송 권한)을 실행할 때 전송됩니다. permission 객체는 요청하는 URL과 요청하는 WebEnginePermission.PermissionType 을 쿼리하고 권한을 부여하거나 거부할 수 있습니다.

이 신호는 QtWebEngine 6.8에 도입되었습니다.

이 신호는 메인 프레임에서 JavaScript window.print() 메서드가 호출되거나 사용자가 PDF 뷰어 플러그인의 인쇄 버튼을 눌렀을 때 발생합니다. 일반적으로 신호 핸들러는 printToPdf()를 호출하면 됩니다.

QtWebEngine 6.8부터 이 신호는 인쇄를 요청하는 모든 프레임에서 발생하는 것이 아니라 메인 프레임에서만 발생합니다.

이 신호는 QtWebEngine 1.8에 도입되었습니다.

printToPdf 를참조하십시오 .

이 신호는 frame 에서 자바스크립트 window.print() 메서드가 호출될 때 발생합니다. 프레임이 메인 프레임인 경우 printRequested 가 대신 발생합니다.

이 신호는 QtWebEngine 6.8에서 도입되었습니다.

printRequested 를참조하십시오 .

이 신호는 오디오가 재생되거나 중지되어 recentlyAudible 에 지정된 페이지의 가청 상태가 변경될 때 발생합니다.

웹 페이지에 순차적으로 시작되는 두 개의 동영상이 포함된 경우 이 신호는 첫 번째 동영상이 사운드를 생성할 때 한 번만 발생합니다. 두 동영상이 모두 중지된 후 마지막으로 사운드가 생성될 때 신호가 방출됩니다. 즉, 오디오 스트림의 수에 관계없이 웹 페이지 내에서 모든 종류의 사운드가 생성될 때와 모든 것이 완전히 침묵할 때 모두 신호가 방출됩니다.

가짜 신호 방출도 발생할 수 있습니다. 예를 들어, 소리가 멈추면 이 신호는 true 값으로 첫 번째 방출되고 false 값으로 두 번째 방출됩니다. 또한 오디오 재생이 시작되면 true 값으로 신호가 두 번 방출됩니다.

이 신호는 QtWebEngine 1.3에 도입되었습니다.

recentlyAudible 를참조하십시오 .

이 신호는 웹 페이지가 등록 프로토콜 핸들러를 발행하여 사용자 정의 프로토콜을 등록하려고 할 때 발생합니다 request.

이 신호는 QtWebEngine 1.7에 도입되었습니다.

RegisterProtocolHandlerRequest 를참조하십시오 .

아직 사용할 수 있는 렌더링 프로세스가 없는 경우 0 이 반환됩니다. 이 신호는 페이지의 기본 렌더링 프로세스의 pid (프로세스 ID)가 변경될 때 발생합니다.

이 신호는 QtWebEngine 1.11에 도입되었습니다.

renderProcessPid 를참조하세요 .

이 신호는 렌더링 프로세스가 종료 상태가 0이 아닌 상태로 종료될 때 발생합니다. terminationStatus 은 프로세스의 종료 상태이고 exitCode 은 프로세스가 종료된 상태 코드입니다.

이 신호는 QtWebEngine 1.2에 도입되었습니다.

RenderProcessTerminationStatus 를참조하십시오 .

이 신호는 웹 사이트에서 SSL 클라이언트 인증서를 요청하고 시스템의 클라이언트 인증서 저장소에서 하나 이상의 인증서가 발견되면 발생합니다.

신호 처리는 비동기식이며 인증서가 선택되거나 clientCertificateSelection 의 마지막 복사본이 삭제될 때까지 로딩이 대기합니다.

신호가 처리되지 않으면 clientCertificateSelection 는 자동으로 삭제되며 클라이언트 인증서 없이 로드가 계속됩니다.

이 신호는 QtWebEngine 1.9에 도입되었습니다.

WebEngineClientCertificateSelection 를참조하세요 .

이 신호는 웹 페이지가 지정된 위치에 툴팁을 표시하기 위해 request 을 전송할 때 발생합니다.

이 신호는 QtWebEngine 1.10에 도입되었습니다.

TooltipRequest 를참조하세요 .

이 신호는 지정된 위치에서 터치 선택 메뉴가 요청될 때 발생합니다.

request 는 TouchSelectionMenuRequest 유형의 메서드를 사용하여 처리할 수 있습니다.

이 신호는 QtWebEngine 6.3에 도입되었습니다.

TouchSelectionMenuRequest 를참조하세요 .

이 신호는 오디오가 재생되거나 중지되어 wasRecentlyAudible 에 지정된 페이지의 가청 상태가 변경될 때 발생합니다.

이 신호는 QtWebEngine 1.3에 도입되었습니다.

이 신호는 인증 프로세스 중에 WebAuth 인증자가 사용자 상호 작용을 요구할 때 발생합니다. 이러한 요청은 사용자에게 대화 상자를 표시하여 처리됩니다.

request 에는 WebAuth UX 요청을 완료하는 데 필요한 정보 및 API가 포함되어 있습니다.

이 신호는 QtWebEngine 6.7에 도입되었습니다.

QWebEngineWebAuthUxRequest 를참조하세요 .

이 신호는 페이지에서 웹 브라우저 창을 닫으라고 요청할 때마다(예: JavaScript window.close() 호출) 발생합니다.

이 신호는 QtWebEngine 1.2에 도입되었습니다.

이 신호는 페이지의 확대/축소 factor 가 변경될 때마다 전송됩니다.

이 신호는 QtWebEngine 6.8에 도입되었습니다.

zoomFactor 를참조하십시오 .

웹 보기의 콘텐츠에서 지정된 script 을 실행합니다.

callback 매개 변수는 선택 사항입니다. 콜백 함수를 제공하면 스크립트 실행이 완료된 후에 호출됩니다.

runJavaScript("document.title", function(result) { console.log(result); });

JavaScript에서 결과 값으로 일반 데이터만 반환할 수 있습니다. 지원되는 데이터 유형에는 모든 JSON 데이터 유형은 물론 Date 및 ArrayBuffer 과 같은 데이터 유형이 포함됩니다. 지원되지 않는 데이터 유형으로는 Function 및 Promise 등이 있습니다.

페이지에서 실행되는 다른 스크립트와의 충돌을 피하기 위해 스크립트가 실행되는 월드는 worldId 으로 지정할 수 있습니다. 월드 ID는 0 와 256 사이여야 합니다. world ID를 생략하면 스크립트는 MainWorld 에서 실행됩니다.

스크립트 삽입에 대한 자세한 내용은 스크립트 삽입을 참조하세요. 스크립트를 삽입하는 다른 방법은 WebEngineView::userScripts 을 참조하세요.

이 뷰에서 request 을 열어 newWindowRequested 신호를 처리합니다.

이 메서드는 QtWebEngine 2.0에 도입되었습니다.

newWindowRequested 를참조하십시오 .

지정된 WebAction action 에 대해 WebEngineAction 를 반환합니다. WebEngineView 도 액션 구현을 처리하므로 트리거 시 해당 액션이 뷰에서 수행됩니다.

var copyAction = webEngineView.action(WebEngineView.Copy);

WebEngineAction도 참조하십시오 .

주어진 name 으로 프레임을 반환합니다. 같은 이름의 프레임이 여러 개 있는 경우 반환되는 프레임은 임의로 결정됩니다. 프레임을 찾을 수 없으면 invalid 프레임을 반환합니다.

이 메서드는 QtWebEngine 6.8에 도입되었습니다.

페이지에서 지정된 문자열 subString 을 찾습니다. 문자열 검색이 완료되면 findTextFinished() 신호가 전송됩니다.

검색 하이라이트를 지우려면 빈 문자열을 전달하면 됩니다.

이 메서드는 QtWebEngine 1.1에 도입되었습니다.

findTextFinished()도 참조하세요 .

주어진 options 을 사용하여 페이지에서 지정된 문자열 subString 을 찾습니다. 문자열 검색이 완료되면 findTextFinished() 신호가 전송됩니다.

검색 하이라이트를 지우려면 빈 문자열을 전달하면 됩니다.

findText("Qt", WebEngineView.FindBackward | WebEngineView.FindCaseSensitively);

이 메서드는 QtWebEngine 1.1에 도입되었습니다.

findTextFinished()도 참조하세요 .

주어진 options 을 사용하여 페이지에서 지정된 문자열 subString 을 찾습니다. 문자열 검색이 완료되면 findTextFinished() 신호가 전송됩니다.

검색 하이라이트를 지우려면 빈 문자열을 전달하면 됩니다.

resultCallback 에는 정수 매개 변수를 사용해야 합니다. 이 함수는 subString 의 발견 횟수와 함께 호출됩니다.

findText("Qt", WebEngineView.FindCaseSensitively, function(matchCount) {
    if (matchCount > 0)
        console.log("'Qt' tokens found:", matchCount);
});

이 메서드는 QtWebEngine 1.1에 도입되었습니다.

findTextFinished()도 참조하세요 .

isFullScreen 속성을 false 로 즉시 설정합니다. 이 메서드는 윈도우 시스템이 애플리케이션을 전체 화면 모드로 강제 종료할 때 브라우저 엔진에 알리는 데 사용할 수 있습니다.

ApplicationWindow {
    onVisibilityChanged: {
        if (webEngineView.isFullScreen && visibility != Window.FullScreen)
            webEngineView.fullScreenCancelled()
    }

    WebEngineView {
        id: webEngineView
        // ...
    }
}

이 메서드는 QtWebEngine 1.1에 도입되었습니다.

isFullScreen 및 fullScreenRequested()도 참조하십시오 .

가능하면 브라우저의 세션 기록 내에서 뒤로 이동합니다. 이 함수는 window.history.back() DOM 메서드와 동일합니다.

canGoBack 를참조하세요 .

offset 이 양수이면 현재 세션 기록에서 지정된 오프셋 페이지 수만큼 앞으로 이동합니다. 오프셋이 음수이면 뒤로 이동합니다. 오프셋이 유효하지 않으면 페이지가 변경되지 않습니다.

이 메서드는 QtWebEngine 1.1에 도입되었습니다.

goBack() 및 goForward()도 참조하세요 .

가능하면 브라우저의 세션 기록 내에서 앞으로 이동합니다. 이 함수는 window.history.forward() DOM 메서드와 동일합니다.

지정된 html 을 웹 보기의 콘텐츠로 로드합니다.

이 메서드는 URL을 통해 HTML 페이지를 참조하는 url 속성에 대한 하위 수준의 대안을 제공합니다.

baseUrl 는 선택 사항이며 참조된 이미지나 스타일시트와 같이 문서에서 상대 URL을 확인하는 데 사용됩니다. 예를 들어 html 가 기본 URL인 http://www.example.com/documents/overview.html 에서 검색되는 경우 상대 URL인 diagram.png 로 참조된 이미지는 http://www.example.com/documents/diagram.png 에 있어야 합니다.

url도 참조하세요 .

WebEngineView 의 현재 콘텐츠를 PDF 문서로 인쇄하여 filePath 에 저장합니다. 문서의 크기는 pageSizeId 값에 의해 결정되고 방향은 orientation 을 사용하여 결정됩니다.

이 메서드는 웹 페이지를 PDF로 인쇄하기 위한 비동기 요청을 발행하고 즉시 반환합니다. 요청 결과에 대한 알림을 받으려면 pdfPrintingFinished() 신호에 연결합니다.

pageSizeId 을 생략하면 기본값은 A4 입니다. orientation 을 생략하면 기본값은 Portrait 입니다.

이 메서드는 QtWebEngine 1.3에 도입되었습니다.

pdfPrintingFinished()도 참조하십시오 .

WebEngineView 의 현재 콘텐츠를 PDF 문서로 인쇄하고 바이트 배열로 반환합니다. 문서의 크기는 pageSizeId 값에 의해 결정되고 방향은 orientation 을 사용하여 결정됩니다.

resultCallback 에는 문자열 매개 변수를 사용해야 합니다. 이 문자열은 인쇄에 성공하면 문서의 데이터를 포함하고 그렇지 않으면 빈 문자열을 포함합니다.

pageSizeId 을 생략하면 기본값은 A4 이며 orientation 을 생략하면 기본값은 Portrait 입니다.

이 메서드는 QtWebEngine 1.3에 도입되었습니다.

현재 페이지를 새로고침합니다. 이 함수는 window.location.reload() DOM 메서드와 동일합니다.

reloadAndBypassCache()도 참조하십시오 .

캐시된 콘텐츠를 무시하고 현재 페이지를 새로고침합니다.

이 메서드는 QtWebEngine 1.1에 도입되었습니다.

reload()도 참조하십시오 .

현재 철자가 틀린 단어를 replacement 로 바꿉니다.

이 메서드는 QtWebEngine 1.3에 도입되었습니다.

현재 웹 페이지를 디스크에 저장합니다.

웹 페이지가 지정된 format 에 filePath 에 저장됩니다.

이것은 다음 작업의 바로 가기입니다:

• 웹 저장 작업을 트리거합니다.
• 다음 다운로드 항목을 수락하고 지정된 파일 경로와 저장 형식을 설정합니다.

이 함수는 웹 페이지에 대한 비동기 다운로드 요청을 발행하고 즉시 반환합니다.

이 메서드는 QtWebEngine 6.6에 도입되었습니다.

QWebEngineDownloadRequest::SavePageFormat 를참조하세요 .

arg 이 true 인 경우 클릭한 웹 엔진 보기에 활성 포커스를 설정합니다. false 로 설정하면 웹 엔진 보기를 사용하여 포커스를 가져 오지 않아야 하는 UI 요소를 만들 수 있습니다. 이는 하이브리드 UI에서 유용할 수 있습니다.

이 메서드는 QtWebEngine 1.2에 도입되었습니다.

activeFocusOnPress, activeFocusOnPressChanged, WebEngineSettings::focusOnNavigationEnabled 를참조하십시오 .

현재 페이지의 로드를 중지합니다.

웹 액션을 트리거합니다 action.

이 메서드는 QtWebEngine 1.2에 도입되었습니다.

WebAction 를참조하십시오 .