QWebEnginePage Class

멤버 함수 문서

페이지의 DOM이 구성되었는지 확인하지 않고 scriptSource 에 포함된 자바스크립트 코드를 실행합니다. 스크립트 실행 방식을 보다 세밀하게 제어하려면 scripts()를 대신 사용하는 것이 좋습니다.

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

스크립트가 실행되면 마지막으로 실행된 문의 결과와 함께 resultCallback 이 호출됩니다. resultCallback 은 함수 포인터, 함수 또는 람다 중 하나이며 QVariant 매개 변수를 사용할 것으로 예상됩니다. 예를 들어

page.runJavaScript("document.title", [](const QVariant &v) { qDebug() << v.toString(); });

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

scripts(), QWebEngineScript::ScriptWorldId, QWebEngineFrame::runJavaScript, 스크립트 인젝션도참조하세요 .

[explicit] QWebEnginePage::QWebEnginePage(QObject *parent = nullptr)

부모가 parent 인 빈 QWebEnginePage 를 생성합니다.

QWebEnginePage::QWebEnginePage(QWebEngineProfile *profile, QObject *parent = nullptr)

웹 엔진 프로필 profile 에 빈 웹 엔진 페이지를 만들고 parent 을 부모로 합니다.

프로필이 기본 프로필이 아닌 경우 호출자는 페이지가 유지되는 기간 동안 프로필이 살아 있는지 확인해야 합니다.

[virtual noexcept] QWebEnginePage::~QWebEnginePage()

웹 페이지를 삭제합니다.

[virtual protected] bool QWebEnginePage::acceptNavigationRequest(const QUrl &url, QWebEnginePage::NavigationType type, bool isMainFrame)

이 함수는 지정된 탐색 유형 type 을 통해 지정된 url 으로 이동하라는 요청을 받으면 호출됩니다. isMainFrame 은 요청이 메인 프레임에 해당하는지 또는 하위 프레임에 해당하는지를 나타냅니다. 함수가 true 을 반환하면 탐색 요청이 수락되고 url 이 로드됩니다. 기본 구현은 모든 탐색 요청을 수락합니다.

탐색 요청은 이 함수를 오버로드하여 HTML 핸들러 엔진이 처리하는 대신 Qt 애플리케이션에 위임할 수 있습니다. 이는 결과 목록을 표시할 때와 같이 외부 데이터를 표시하지 않고 사용자 인터페이스의 일부로 HTML 문서를 사용할 때 필요합니다.

QWebEngineUrlRequestInterceptor 클래스는 요청을 가로채고 조작하기 위한 추가 옵션을 제공합니다.

QAction *QWebEnginePage::action(QWebEnginePage::WebAction action) const

지정된 WebAction action 에 대해 QAction 를 반환합니다.

이 액션은 QWebEnginePage 에서 소유하지만 속성을 변경하여 모양을 사용자 지정할 수 있습니다.

반환된 액션에는 기본 스타일 아이콘이 없습니다. 기본 스타일 아이콘이 있는 액션을 만들려면 QWebEngineView::pageAction()를 사용합니다.

QWebEnginePage 또한 액션 구현을 처리하여 트리거 시 해당 액션이 페이지에서 수행되도록 합니다.

triggerAction()도 참조하세요 .

[signal] void QWebEnginePage::audioMutedChanged(bool muted)

이 신호는 페이지의 muted 상태가 변경될 때 발생합니다.

[signal] void QWebEnginePage::authenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator)

이 신호는 requestUrl 에 액세스하려면 인증이 필요할 때 전송됩니다. authenticator 을 사용하여 연결에 대한 사용자 이름과 비밀번호를 전달해야 합니다.

[signal] void QWebEnginePage::certificateError(const QWebEngineCertificateError &certificateError)

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

certificateError 매개변수에는 인증서에 대한 정보와 오류의 세부 정보가 포함되어 있으며, 오류를 무시하고 요청을 완료하거나 요청 로드를 중지하는 방법도 제공합니다.

QWebEngineCertificateError 를참조하세요 .

[virtual protected] QStringList QWebEnginePage::chooseFiles(QWebEnginePage::FileSelectionMode mode, const QStringList &oldFiles, const QStringList &acceptedMimeTypes)

이 함수는 사용자가 HTML 양식에서 파일 업로드 버튼을 클릭하는 등 웹 콘텐츠가 파일 이름을 요청할 때 호출됩니다.

mode 는 하나의 파일만 반환할지 여러 개의 파일을 반환할지를 나타냅니다.

제안된 파일명은 oldFiles 의 첫 번째 항목으로 제공될 수 있습니다. acceptedMimeTypes 은 기본 구현에서는 무시되지만 재정의에 의해 사용될 수 있습니다.

[virtual protected] QWebEnginePage *QWebEnginePage::createWindow(QWebEnginePage::WebWindowType type)

이 함수는 지정된 type 의 새 창을 만들기 위해 호출됩니다. 예를 들어 자바스크립트 프로그램에서 새 창에서 문서를 열도록 요청할 때 사용합니다.

새 창을 만들 수 있으면 새 창의 QWebEnginePage 이 반환되고, 그렇지 않으면 널 포인터가 반환됩니다.

웹 페이지와 연결된 보기가 QWebEngineView 객체인 경우 기본 구현은 요청을 QWebEngineView::createWindow()로 전달하고, 그렇지 않으면 null 포인터를 반환합니다.

이 호출이 구현되지 않았거나 새 페이지를 반환하지 않으면 newWindowRequested()가 호출되어 요청을 처리합니다.

QWebEngineView::createWindow() 및 newWindowRequested()도 참조하세요 .

[signal, since 6.7] void QWebEnginePage::desktopMediaRequested(const QWebEngineDesktopMediaRequest &request)

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

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

이 함수는 Qt 6.7에 도입되었습니다.

[since 6.6] QString QWebEnginePage::devToolsId() const

이 페이지와 연결된 개발자 도구 호스트의 ID를 반환합니다.

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

이 기능은 Qt 6.6에 도입되었습니다.

QWebEnginePage *QWebEnginePage::devToolsPage() const

이 페이지의 개발자 도구를 호스팅하는 페이지가 있는 경우 해당 페이지를 반환합니다.

개발자 도구 페이지가 설정되어 있지 않으면 nullptr 를 반환합니다.

setDevToolsPage() 및 inspectedPage()도 참조하세요 .

void QWebEnginePage::download(const QUrl &url, const QString &filename = QString())

url 에서 지정한 위치에서 로컬 파일로 리소스를 다운로드합니다.

filename 이 지정되면 이 이름이 추천 파일 이름으로 사용됩니다. 상대적인 파일 이름인 경우 파일은 지정된 이름의 표준 다운로드 위치에 저장됩니다. 널이거나 비어 있는 QString 인 경우 기본 파일 이름이 사용됩니다.

다운로드가 시작된 후 QWebEngineProfile::downloadRequested()가 전송됩니다.

[override virtual] bool QWebEnginePage::event(QEvent *e)

다시 구현합니다: QObject::event(QEvent *e).

[signal, since 6.4] void QWebEnginePage::fileSystemAccessRequested(QWebEngineFileSystemAccessRequest request)

이 신호는 웹 페이지에서 로컬 파일 또는 디렉토리에 대한 액세스를 요청할 때 전송됩니다.

요청 객체 request 는 요청을 수락하거나 거부하는 데 사용할 수 있습니다.

이 함수는 Qt 6.4에 도입되었습니다.

[since 6.8] std::optional<QWebEngineFrame> QWebEnginePage::findFrameByName(QAnyStringView name)

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

이 함수는 Qt 6.8에 도입되었습니다.

void QWebEnginePage::findText(const QString &subString, QWebEnginePage::FindFlags options = {}, const std::function<void (const QWebEngineFindTextResult &)> &resultCallback = std::function<void(const QWebEngineFindTextResult &)>())

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

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

resultCallback 에는 QWebEngineFindTextResult 매개 변수를 사용해야 합니다.

예를 들어

    m_view->page()->findText(QStringLiteral("Qt"), QWebEnginePage::FindFlags(), [this](const QWebEngineFindTextResult &result) {
        if (result.numberOfMatches() == 0) QMessageBox::information(m_view, QString(), QStringLiteral("No occurrences found"));
    });

findTextFinished()도 참조하세요 .

[signal] void QWebEnginePage::findTextFinished(const QWebEngineFindTextResult &result)

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

findText()도 참조하세요 .

[signal] void QWebEnginePage::fullScreenRequested(QWebEngineFullScreenRequest fullScreenRequest)

이 신호는 웹 페이지에서 웹 요소(일반적으로 동영상 요소)에 대해 전체 화면 모드로 전환하라는 요청을 발행할 때 전송됩니다.

요청 객체 fullScreenRequest 를 사용하여 요청을 수락하거나 거부할 수 있습니다.

요청이 수락되면 전체 화면을 요청하는 요소가 뷰포트를 채우지만 뷰를 전체 화면으로 만들거나 페이지를 전체 화면 뷰로 이동하는 것은 애플리케이션에 달려 있습니다.

QWebEngineSettings::FullScreenSupportEnabled 를참조하십시오 .

[signal] void QWebEnginePage::geometryChangeRequested(const QRect &geom)

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

window->setGeometry(geom.marginsRemoved(window->frameMargins()));

QWebEngineHistory *QWebEnginePage::history() const

뷰에서 탐색한 웹 페이지의 기록에 대한 포인터를 반환합니다.

[signal] void QWebEnginePage::iconChanged(const QIcon &icon)

이 신호는 페이지와 연결된 아이콘('파비콘')이 변경될 때 발생합니다. 새 아이콘은 icon 에 의해 지정됩니다.

icon(), iconUrl() 및 iconUrlChanged()도 참조하세요 .

[signal] void QWebEnginePage::iconUrlChanged(const QUrl &url)

이 신호는 페이지와 연결된 아이콘('파비콘')의 URL이 변경될 때 발생합니다. 새 URL은 url 로 지정됩니다.

iconUrl(), icon() 및 iconChanged()도 참조하세요 .

QWebEnginePage *QWebEnginePage::inspectedPage() const

이 페이지가 검사 중인 페이지가 있으면 반환합니다.

이 페이지가 개발자 도구 페이지가 아닌 경우 nullptr 를 반환합니다.

setInspectedPage() 및 devToolsPage()도 참조하세요 .

[virtual protected] void QWebEnginePage::javaScriptAlert(const QUrl &securityOrigin, const QString &msg)

이 함수는 securityOrigin 에 연결된 프레임에서 실행 중인 자바스크립트 프로그램이 msg 메시지와 함께 alert() 함수를 호출할 때마다 호출됩니다.

기본 구현은 QMessageBox::information 이라는 메시지와 함께 msg 라는 메시지를 표시합니다.

[virtual protected] bool QWebEnginePage::javaScriptConfirm(const QUrl &securityOrigin, const QString &msg)

이 함수는 securityOrigin 에 연결된 프레임에서 실행 중인 자바스크립트 프로그램이 msg 메시지와 함께 confirm() 함수를 호출할 때마다 호출됩니다. 사용자가 메시지를 확인하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

또한 onbeforeunload 핸들러가 페이지를 떠나기 전에 확인을 요청할 때도 호출됩니다.

기본 구현은 QMessageBox::Ok 및 QMessageBox::Cancel 버튼과 함께 QMessageBox::information 을 사용하여 쿼리를 실행합니다.

[virtual protected] void QWebEnginePage::javaScriptConsoleMessage(QWebEnginePage::JavaScriptConsoleMessageLevel level, const QString &message, int lineNumber, const QString &sourceID)

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

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

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

Qt 5.6부터 기본 구현은 js logging category 에 메시지를 기록합니다.

콘솔 로깅도참조하십시오 .

[virtual protected] bool QWebEnginePage::javaScriptPrompt(const QUrl &securityOrigin, const QString &msg, const QString &defaultValue, QString *result)

이 함수는 securityOrigin 에 연결된 프레임에서 실행 중인 자바스크립트 프로그램이 사용자에게 입력을 요청할 때마다 호출됩니다. 프로그램은 선택적 메시지인 msg 와 defaultValue 의 기본 입력값을 제공할 수 있습니다.

사용자가 프롬프트를 취소한 경우 구현은 false 을 반환해야 하며, 그렇지 않은 경우 result 에 결과를 기록하고 true 을 반환해야 합니다. 사용자가 프롬프트를 취소하지 않은 경우 구현은 true 을 반환해야 하며 결과 문자열은 null이 아니어야 합니다.

기본 구현은 QInputDialog::getText()를 사용합니다.

[signal] void QWebEnginePage::linkHovered(const QString &url)

이 신호는 마우스가 링크 위로 마우스를 가져갈 때 발생합니다. url 링크의 대상 URL이 포함되어 있습니다.

void QWebEnginePage::load(const QUrl &url)

url 을 이 페이지에 로드합니다.

setUrl(), setHtml() 및 setContent()도 참조하세요 .

void QWebEnginePage::load(const QWebEngineHttpRequest &request)

지정된 request 을 발행하고 응답을 로드합니다.

load(), setUrl(), url(), urlChanged() 및 QUrl::fromUserInput()도 참조하세요 .

[signal] void QWebEnginePage::loadFinished(bool ok)

이 신호는 페이지가 콘텐츠 로드를 완료할 때 발생합니다. 이 신호는 스크립트 실행이나 페이지 렌더링과는 무관합니다. ok 은 로드가 성공했는지 또는 오류가 발생했는지를 나타냅니다.

loadStarted() 및 acceptNavigationRequest()도 참조하세요 .

[signal] void QWebEnginePage::loadProgress(int progress)

이 신호는 글로벌 진행 상태가 변경될 때 발생합니다. 현재 값은 progress 에서 제공하며 기본 범위인 QProgressBar 의 0에서 100까지 스케일링됩니다. 모든 하위 프레임의 변경 사항을 누적합니다.

[signal] void QWebEnginePage::loadStarted()

이 신호는 페이지에서 콘텐츠 로딩이 시작될 때 발생합니다.

loadFinished() 및 acceptNavigationRequest()도 참조하세요 .

[signal, since 6.2] void QWebEnginePage::loadingChanged(const QWebEngineLoadingInfo &loadingInfo)

이 신호는 loadingInfo 로 지정된 페이지 로딩이 시작, 종료 또는 실패할 때 발생합니다.

이 함수는 Qt 6.2에 도입되었습니다.

[since 6.8] QWebEngineFrame QWebEnginePage::mainFrame()

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

이 기능은 Qt 6.8에 도입되었습니다.

[signal, since 6.2] void QWebEnginePage::navigationRequested(QWebEngineNavigationRequest &request)

이 신호는 acceptNavigationRequest() 호출과 함께 내비게이션에서 전송됩니다. request 을 수락하거나 무시하는 데 사용할 수 있습니다. 기본값은 수락입니다.

이 함수는 Qt 6.2에 도입되었습니다.

acceptNavigationRequest()도 참조하세요 .

[signal, since 6.2] void QWebEnginePage::newWindowRequested(QWebEngineNewWindowRequest &request)

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

이 신호는 요청에 대한 새 페이지와 함께 openIn()을 호출하여 처리됩니다. 이 신호가 처리되지 않으면 요청된 로드가 실패합니다.

이 함수는 Qt 6.2에 도입되었습니다.

createWindow() 및 QWebEngineNewWindowRequest::openIn()도 참조하세요 .

[signal] void QWebEnginePage::pdfPrintingFinished(const QString &filePath, bool success)

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

printToPdf()도 참조하세요 .

[signal, since 6.8] void QWebEnginePage::permissionRequested(QWebEnginePermission permission)

이 신호는 웹 사이트에서 기능(예: 위치 정보 액세스, 알림 전송 권한)을 사용하도록 요청할 때 전송됩니다. permission 객체는 요청하는 URL과 요청하는 QWebEnginePermission::Feature 을 쿼리하고 권한을 부여하거나 거부할 수 있습니다.

이 기능은 Qt 6.8에 도입되었습니다.

[signal] void QWebEnginePage::printRequested()

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

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

printToPdf() 및 printRequestedByFrame()도 참조하세요 .

[signal, since 6.8] void QWebEnginePage::printRequestedByFrame(QWebEngineFrame frame)

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

이 함수는 Qt 6.8에 도입되었습니다.

printRequested(), printToPdf() 및 QWebEngineFrame::printToPdf()도 참조하십시오 .

void QWebEnginePage::printToPdf(const QString &filePath, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

페이지의 현재 콘텐츠를 PDF 문서로 렌더링하여 filePath 에 지정된 위치에 저장합니다. 생성된 PDF 문서의 페이지 크기와 방향은 layout 에 지정된 값에서 가져오며, 인쇄되는 페이지 범위는 ranges 에서 가져오며 기본값은 모든 페이지를 인쇄하는 것입니다.

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

제공된 파일 경로에 파일이 이미 있는 경우 덮어쓰기됩니다.

pdfPrintingFinished()도 참조하세요 .

void QWebEnginePage::printToPdf(const std::function<void (const QByteArray &)> &resultCallback, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

페이지의 현재 콘텐츠를 PDF 문서로 렌더링하고 PDF 데이터가 포함된 바이트 배열을 resultCallback 에 파라미터로 반환합니다. 생성된 PDF 문서의 페이지 크기와 방향은 layout 에 지정된 값에서 가져오고, 인쇄되는 페이지 범위는 ranges 에서 가져오는데 기본값은 모든 페이지를 인쇄하는 것입니다.

resultCallback 은 QByteArray 에 대한 상수 참조를 매개변수로 가져와야 합니다. 인쇄에 성공하면 이 바이트 배열에 PDF 데이터가 포함되며, 그렇지 않으면 바이트 배열이 비어 있습니다.

QWebEngineProfile *QWebEnginePage::profile() const

페이지가 속한 웹 엔진 프로필을 반환합니다.

[signal] void QWebEnginePage::proxyAuthenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator, const QString &proxyHost)

proxyHost 을 통해 requestUrl 에 액세스하려면 프록시 인증이 필요할 때 이 신호가 전송됩니다. authenticator 을 사용하여 연결에 대한 사용자 이름과 비밀번호를 전달해야 합니다.

[signal] void QWebEnginePage::recentlyAudibleChanged(bool recentlyAudible)

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

[signal] void QWebEnginePage::registerProtocolHandlerRequested(QWebEngineRegisterProtocolHandlerRequest request)

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

요청 객체 request 를 사용하여 요청을 수락하거나 거부할 수 있습니다:

void WebView::handleRegisterProtocolHandlerRequested(
        QWebEngineRegisterProtocolHandlerRequest request)
{
    auto answer = QMessageBox::question(window(), tr("Permission Request"),
                                        tr("Allow %1 to open all %2 links?")
                                                .arg(request.origin().host())
                                                .arg(request.scheme()));
    if (answer == QMessageBox::Yes)
        request.accept();
    else
        request.reject();
}

[signal] void QWebEnginePage::renderProcessPidChanged(qint64 pid)

이 신호는 기본 렌더링 프로세스 PID, pid, 가 변경될 때 발생합니다.

[signal] void QWebEnginePage::renderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode)

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

void QWebEnginePage::replaceMisspelledWord(const QString &replacement)

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

현재 철자가 틀린 단어는 QWebEngineContextMenuRequest::misspelledWord()에서, 제안된 대체 단어는 QWebEngineContextMenuRequest::spellCheckerSuggestions()에서 확인할 수 있습니다.

void QWebEnginePage::save(const QString &filePath, QWebEngineDownloadRequest::SavePageFormat format = QWebEngineDownloadRequest::MimeHtmlSaveFormat) const

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

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

이것은 다음 작업의 단축키입니다:

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

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

QWebEngineDownloadRequest::SavePageFormat 를참조하세요 .

QWebEngineScriptCollection &QWebEnginePage::scripts()

페이지에 삽입된 스크립트 모음을 반환합니다.

또한 페이지에서 QWebEngineProfile::scripts()를 통해 추가된 스크립트를 실행할 수도 있습니다.

QWebEngineScriptCollection, QWebEngineScript, 스크립트 인젝션도참조하세요 .

[signal] void QWebEnginePage::selectClientCertificate(QWebEngineClientCertificateSelection clientCertificateSelection)

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

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

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

QWebEngineClientCertificateSelection 를참조하세요 .

[signal] void QWebEnginePage::selectionChanged()

이 신호는 대화형 또는 프로그래밍 방식으로 선택 항목이 변경될 때마다 발생합니다. 예를 들어, 선택 동작으로 triggerAction()를 호출합니다.

selectedText()도 참조하세요 .

void QWebEnginePage::setContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl())

웹 페이지의 콘텐츠를 data 로 설정합니다. mimeType 인수가 비어 있으면 콘텐츠가 text/plain,charset=US-ASCII 인 것으로 간주합니다.

콘텐츠에서 참조된 외부 객체는 baseUrl 에 상대적인 위치에 있습니다. 상대 URL을 가진 외부 객체가 로드되는 경우 baseUrl 는 비어 있을 수 없습니다.

data 은 즉시 로드되고 외부 객체는 비동기적으로 로드됩니다.

toHtml() 및 setHtml()도 참조하세요 .

void QWebEnginePage::setDevToolsPage(QWebEnginePage *devToolsPage)

devToolsPage 을 이 페이지의 개발자 도구로 바인딩합니다. devToolsPage 을 트리거하여 개발자 도구가 있는 내부 URL로 이동합니다.

이는 devToolsPage 에서 this 인수를 사용하여 setInspectedPage()를 호출하는 것과 동일합니다.

devToolsPage() 및 setInspectedPage()도 참조하세요 .

void QWebEnginePage::setHtml(const QString &html, const QUrl &baseUrl = QUrl())

이 페이지의 콘텐츠를 html 로 설정합니다. baseUrl 은 선택 사항이며 참조된 이미지 또는 스타일시트와 같은 문서의 상대 URL을 확인하는 데 사용됩니다.

html 은 즉시 로드되며 외부 객체는 비동기적으로 로드됩니다.

예를 들어 모달 JavaScript 경고 대화 상자에 의해 차단되어 html 스크립트가 기본 스크립트 시간 초과(현재 10초)보다 오래 실행되는 경우 이 메서드는 시간 초과 후 가능한 한 빨리 반환되며 이후의 html 은 비동기적으로 로드됩니다.

이 메서드를 사용할 때 웹 엔진은 달리 지정하지 않는 한 JavaScript 프로그램이나 스타일시트와 같은 외부 리소스가 UTF-8로 인코딩되어 있다고 가정합니다. 예를 들어 외부 스크립트의 인코딩은 HTML 스크립트 태그의 문자 집합 속성을 통해 지정할 수 있습니다. 웹 서버에서 인코딩을 지정할 수도 있습니다.

이는 setContent(html, "text/html", baseUrl)와 같은 편의 기능입니다.

toHtml(), setContent() 및 load()도 참조하세요 .

void QWebEnginePage::setInspectedPage(QWebEnginePage *page)

이 페이지를 page 의 개발자 도구인 내부 URL로 이동합니다.

이는 page 에서 this 를 인수로 사용하여 setDevToolsPage()를 호출하는 것과 동일합니다.

inspectedPage() 및 setDevToolsPage()도 참조하세요 .

void QWebEnginePage::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

URL 요청을 가로채기 위해 요청 인터셉터 interceptor 를 등록합니다.

이 페이지는 포인터의 소유권을 갖지 않습니다. 이 인터셉터는 프로필의 모든 인터셉터 다음에 호출되며 프로필 인터셉터와 달리 이 페이지의 URL 요청만 인터셉트됩니다. 원래 요청이 프로필 인터셉터에 의해 이미 차단되거나 리디렉션된 경우 이 요청은 인터셉트되지 않습니다.

요청 인터셉터 설정을 해제하려면 nullptr.

QWebEngineUrlRequestInfo 및 QWebEngineProfile::setUrlRequestInterceptor()도 참조하세요 .

void QWebEnginePage::setWebChannel(QWebChannel *channel, quint32 worldId = 0)

이 페이지에서 사용할 웹 채널 인스턴스를 channel 로 설정하고 Chromium IPC 메시지를 사용하여 웹 엔진의 전송에 연결합니다. 전송은 자바스크립트 월드 worldId 에 qt.webChannelTransport 로 노출되며, Qt WebChannel 자바스크립트 API를 사용할 때 사용해야 합니다.

webChannel() 및 QWebEngineScript::ScriptWorldId 을참조하세요 .

QWebEngineSettings *QWebEnginePage::settings() const

페이지의 설정 개체에 대한 포인터를 반환합니다.

[signal] void QWebEnginePage::titleChanged(const QString &title)

이 신호는 페이지 제목이 변경될 때마다 전송됩니다. title 문자열은 새 제목을 지정합니다.

title()도 참조하세요 .

void QWebEnginePage::toHtml(const std::function<void (const QString &)> &resultCallback) const

페이지의 콘텐츠를 HTML 및 BODY 태그로 묶어 HTML로 검색하는 비동기 방식입니다. 성공적으로 완료되면 resultCallback 페이지의 콘텐츠와 함께 호출됩니다.

setHtml() 및 toPlainText()도 참조하세요 .

void QWebEnginePage::toPlainText(const std::function<void (const QString &)> &resultCallback) const

모든 HTML 서식이 완전히 제거된 일반 텍스트로 변환된 페이지의 콘텐츠를 검색하는 비동기 방식입니다. 성공적으로 완료되면 resultCallback 페이지의 콘텐츠와 함께 호출됩니다.

toHtml()도 참조하세요 .

[virtual] void QWebEnginePage::triggerAction(QWebEnginePage::WebAction action, bool checked = false)

이 함수는 지정된 action 을 트리거하기 위해 호출할 수 있습니다. 사용자가 컨텍스트 메뉴 항목 등을 통해 동작을 트리거하는 경우 Qt WebEngine 에서도 호출할 수 있습니다.

action 이 확인 가능한 작업인 경우 checked 은 작업의 토글 여부를 지정합니다.

action()도 참조하세요 .

[signal] void QWebEnginePage::urlChanged(const QUrl &url)

이 신호는 페이지 제목이 수신될 때 페이지의 URL과 함께 전송됩니다. 새 URL은 url 로 지정됩니다.

url()도 참조하세요 .

[signal, since 6.7] void QWebEnginePage::webAuthUxRequested(QWebEngineWebAuthUxRequest *request)

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

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

이 기능은 Qt 6.7에 도입되었습니다.

QWebEngineWebAuthUxRequest 를참조하세요 .

QWebChannel *QWebEnginePage::webChannel() const

이 페이지에서 사용하는 웹 채널 인스턴스에 대한 포인터를 반환하거나 설정된 것이 없는 경우 널 포인터를 반환합니다. 이 채널은 이 페이지의 자바스크립트 컨텍스트에 qt.webChannelTransport 로 노출되는 크롬 IPC를 통한 내부 웹 엔진 전송 메커니즘을 자동으로 사용합니다.

setWebChannel()도 참조하세요 .

[signal] void QWebEnginePage::windowCloseRequested()

이 신호는 페이지에서 웹 브라우저 창을 닫으라고 요청할 때마다 발생하며, 예를 들어 JavaScript window.close() 호출을 통해 전송됩니다.

RequestClose도 참조하세요 .

[signal, since 6.8] void QWebEnginePage::zoomFactorChanged(qreal factor)

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

이 함수는 Qt 6.8에 도입되었습니다.

zoomFactor() 및 setZoomFactor()도 참조하세요 .