webEngineFrame QML Value Type

웹엔진프레임은 페이지 프레임에 대한 정보와 제어 기능을 제공합니다. 더 보기...

Import Statement: import QtWebEngine
Since: Qt 6.8
In C++: QWebEngineFrame

속성

방법

상세 설명

웹 엔진 프레임은 <frame> 또는 <iframe> HTML 요소로 생성된 프레임과 같이 웹 페이지 내의 단일 프레임을 나타냅니다. 활성 WebEngineView 에는 트리 구조로 배열된 하나 이상의 프레임이 있습니다. 이 트리의 루트인 최상위 프레임은 뷰의 mainFrame 속성을 통해 액세스할 수 있습니다.

프레임의 수명은 최대 프레임을 생성한 WebEngineView 개체만큼 길어집니다. 그러나 프레임은 탐색 및 스크립트 실행 등을 통해 자발적이고 동적으로 생성 및 삭제될 수 있습니다.

속성 문서

htmlName : string [read-only]

프레임의 name HTML 속성 값을 반환하거나 속성이 없는 경우 빈 문자열을 반환합니다.

프레임을 찾을 수 없는 경우 빈 문자열을 반환합니다.

name참조하세요 .


isMainFrame : bool [read-only]

이 객체가 페이지의 기본 프레임을 나타내는 경우 true, 그렇지 않으면 false 을 반환합니다.


isValid : bool [read-only]

이 객체가 기존 프레임을 나타내는 경우 true, 그렇지 않으면 false 을 반환합니다.

프레임이 유효하지 않으면 다시는 유효하지 않습니다.


name : string [read-only]

프레임 이름, 즉 자바스크립트에서 window.name 에 의해 반환되는 것을 반환합니다.

프레임을 찾을 수 없는 경우 빈 문자열을 반환합니다.

htmlName참조하세요 .


size : size [read-only]

뷰포트 내 프레임의 크기를 반환합니다.

프레임을 찾을 수 없는 경우 치수가 (-1, -1)인 기본 크기를 반환합니다.


url : url [read-only]

현재 이 프레임에 로드된 콘텐츠의 URL을 반환합니다.

프레임을 찾을 수 없으면 빈 URL을 반환합니다.


메서드 문서

void runJavaScript(string script, uint worldId, variant callback)

void runJavaScript(string script, variant callback)

페이지의 DOM이 구성되었는지 여부를 확인하지 않고 이 프레임에서 script 에 포함된 자바스크립트 코드를 실행합니다.

페이지에서 실행되는 다른 스크립트와의 충돌을 피하기 위해 스크립트가 실행되는 세계는 worldId 로 지정됩니다. 월드 ID 값은 QWebEngineScript::ScriptWorldId 에서 제공하는 것과 동일하며 0256 사이입니다. world ID를 생략하면 스크립트는 MainWorld 에서 실행됩니다.

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

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

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

스크립트는 로드된 사이트의 일부인 다른 스크립트와 동일한 세계에서 실행됩니다.

경고: 콜백 함수에서 긴 루틴을 실행하면 웹 콘텐츠의 렌더링이 차단될 수 있으므로 실행하지 마세요.

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


void printToPdf(string filePath)

프레임의 현재 콘텐츠를 PDF 문서로 인쇄하여 filePath 에 저장합니다. 결과 문서는 A4 페이지 크기와 세로 방향이 됩니다.

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

WebEngineView::pdfPrintingFinished()도 참조하세요 .


void printToPdf(variant callback)

프레임의 현재 콘텐츠를 PDF 문서로 인쇄하고 바이트 배열로 반환합니다. 결과 문서는 A4 페이지 크기와 세로 방향을 갖습니다.

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


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