QWebEngineView Class

멤버 함수 문서

[explicit] QWebEngineView::QWebEngineView(QWidget *parent = nullptr)

부모 parent 를 사용하여 빈 웹 뷰를 구성합니다.

load()도 참조하세요 .

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEnginePage *page, QWidget *parent = nullptr)

parent 을 부모로 하여 page 을 포함하는 웹 뷰를 구성합니다.

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

load() 및 setPage()도 참조하십시오 .

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEngineProfile *profile, QWidget *parent = nullptr)

부모 parent 와 함께 profile 를 사용하여 빈 웹 뷰를 구성합니다.

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

load()도 참조하십시오 .

[virtual noexcept] QWebEngineView::~QWebEngineView()

웹 보기를 삭제합니다.

[slot] void QWebEngineView::back()

링크를 탐색하여 만든 문서 목록에서 이전 문서를 로드하는 편의 슬롯입니다. 이전 문서가 없으면 아무 작업도 수행하지 않습니다.

에 해당합니다:

    view->page()->triggerAction(QWebEnginePage::Back);

forward() 및 pageAction()도 참조하세요 .

[override virtual protected] void QWebEngineView::closeEvent(QCloseEvent *event)

다시 구현합니다: QWidget::closeEvent(QCloseEvent * 이벤트).

[override virtual protected] void QWebEngineView::contextMenuEvent(QContextMenuEvent *event)

다시 구현합니다: QWidget::contextMenuEvent(QContextMenuEvent * 이벤트).

QMenu *QWebEngineView::createStandardContextMenu()

표준 컨텍스트 메뉴를 만들고 이에 대한 포인터를 반환합니다.

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

이 함수는 페이지에서 지정된 type 의 새 창을 만들려고 할 때마다 연결된 QWebEnginePage 의 createWindow() 메서드에서 호출됩니다. 예를 들어 새 창에서 문서를 열라는 자바스크립트 요청이 실행될 때 호출됩니다.

QWebEnginePage::createWindow()도 참조하세요 .

[override virtual protected] void QWebEngineView::dragEnterEvent(QDragEnterEvent *e)

다시 구현합니다: QWidget::dragEnterEvent(QDragEnterEvent * 이벤트).

[override virtual protected] void QWebEngineView::dragLeaveEvent(QDragLeaveEvent *e)

다시 구현합니다: QWidget::dragLeaveEvent(QDragLeaveEvent * 이벤트).

[override virtual protected] void QWebEngineView::dragMoveEvent(QDragMoveEvent *e)

다시 구현합니다: QWidget::dragMoveEvent(QDragMoveEvent * 이벤트).

[override virtual protected] void QWebEngineView::dropEvent(QDropEvent *e)

다시 구현합니다: QWidget::dropEvent(QDropEvent * 이벤트).

[override virtual protected] bool QWebEngineView::event(QEvent *ev)

다시 구현합니다: QWidget::event(QEvent * 이벤트).

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

주어진 options 을 사용하여 페이지에서 지정된 문자열 subString 을 찾습니다.

선택을 지우려면 빈 문자열을 전달하면 됩니다.

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

selectedText() 및 selectionChanged()도 참조하세요 .

[static, since 6.2] QWebEngineView *QWebEngineView::forPage(const QWebEnginePage *page)

page 와 연관된 뷰가 있으면 반환합니다.

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

page() 및 setPage()도 참조하십시오 .

[slot] void QWebEngineView::forward()

링크를 탐색하여 만든 문서 목록에서 다음 문서를 로드하는 편의 슬롯입니다. 다음 문서가 없으면 아무 작업도 수행하지 않습니다.

에 해당합니다:

    view->page()->triggerAction(QWebEnginePage::Forward);

back() 및 pageAction()도 참조하세요 .

[override virtual protected] void QWebEngineView::hideEvent(QHideEvent *event)

다시 구현합니다: QWidget::hideEvent(QHideEvent * 이벤트).

QWebEngineHistory *QWebEngineView::history() const

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

다음과 같습니다:

    view->page()->history();

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

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

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

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

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

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

[since 6.2] QWebEngineContextMenuRequest *QWebEngineView::lastContextMenuRequest() const

현재 컨텍스트 메뉴에 대한 추가 데이터를 반환합니다. contextMenuEvent ()를 호출하는 동안에만 유효합니다.

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

createStandardContextMenu()도 참조하세요 .

void QWebEngineView::load(const QUrl &url)

지정된 url 을 로드하여 표시합니다.

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

void QWebEngineView::load(const QWebEngineHttpRequest &request)

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

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

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

이 신호는 페이지 로드가 완료되면 전송됩니다. ok 는 로드가 성공했는지 또는 오류가 발생했는지를 나타냅니다.

loadStarted()도 참조하세요 .

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

이 신호는 임베드된 이미지나 스크립트 등 웹 보기의 요소가 로딩을 완료할 때마다 발생합니다. 따라서 웹 보기 로딩의 전체 진행 상황을 추적합니다.

현재 값은 progress 에서 제공하며 0에서 100 사이의 스케일이며 기본 범위는 QProgressBar 입니다.

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

[signal] void QWebEngineView::loadStarted()

이 신호는 페이지의 새 로드가 시작될 때 발생합니다.

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

QWebEnginePage *QWebEngineView::page() const

기본 웹 페이지에 대한 포인터를 반환합니다.

setPage()도 참조하세요 .

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

지정된 웹 액션 action 을 캡슐화하는 QAction 에 대한 포인터를 반환합니다. 이 함수는 기본 스타일 아이콘이 없는 경우 QAction 로 설정하기도 합니다.

[signal, since 6.2] void QWebEngineView::pdfPrintingFinished(const QString &filePath, bool success)

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

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

printToPdf()도 참조하세요 .

[since 6.2] void QWebEngineView::print(QPrinter *printer)

페이지의 현재 콘텐츠를 임시 PDF 문서로 렌더링한 다음 printer 을 사용하여 인쇄합니다.

PDF 문서 생성 및 인쇄를 위한 설정은 printer 객체에서 검색됩니다.

완료되면 성공 시 true, 실패 시 false 신호와 함께 printFinished() 신호가 전송됩니다.

printFinished() 신호가 전송될 때까지 printer 신호가 유효한지 확인하는 것은 사용자의 책임입니다.

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

[signal, since 6.2] void QWebEngineView::printFinished(bool success)

이 신호는 print()로 요청한 인쇄가 완료되면 전송됩니다. 파라미터 success 는 성공 시 true, 실패 시 false 입니다.

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

print()도 참조하십시오 .

[signal, since 6.2] void QWebEngineView::printRequested()

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

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

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

printRequestedByFrame() 및 print()도 참조하십시오 .

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

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

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

printRequested() 및 print()도 참조하십시오 .

[since 6.2] void QWebEngineView::printToPdf(const QString &filePath, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

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

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

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

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

pdfPrintingFinished()도 참조하세요 .

[since 6.2] void QWebEngineView::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 데이터가 포함되며, 그렇지 않으면 바이트 배열이 비어 있습니다.

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

[slot] void QWebEngineView::reload()

현재 문서를 다시 로드합니다.

stop(), pageAction() 및 loadStarted()도 참조하세요 .

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

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

[signal] void QWebEngineView::selectionChanged()

이 신호는 선택 내용이 변경될 때마다 발생합니다.

selectedText()도 참조하세요 .

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

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

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

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

load(), setHtml() 및 QWebEnginePage::toHtml()도 참조하세요 .

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

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

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

HTML 문서는 즉시 로드되는 반면 외부 객체는 비동기적으로 로드됩니다.

이 방법을 사용할 때 Qt WebEngine 는 별도로 지정하지 않는 한 JavaScript 프로그램이나 스타일시트 등의 외부 리소스가 UTF-8로 인코딩되어 있다고 가정합니다. 예를 들어 외부 스크립트의 인코딩은 HTML 스크립트 태그의 charset 속성을 통해 지정할 수 있습니다. 또는 웹 서버에서 인코딩을 지정할 수도 있습니다.

이는 setContent(html, "text/html;charset=UTF-8", baseUrl) 와 같은 편의 기능입니다.

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

void QWebEngineView::setPage(QWebEnginePage *page)

page 을 웹 보기의 새 웹 페이지로 만듭니다.

제공된 페이지의 부모 QObject 는 개체의 소유자로 유지됩니다. 현재 페이지가 웹 보기의 하위 페이지인 경우 삭제됩니다.

page()도 참조하세요 .

QWebEngineSettings *QWebEngineView::settings() const

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

에 해당합니다:

    view->page()->settings();

[override virtual protected] void QWebEngineView::showEvent(QShowEvent *event)

다시 구현합니다: QWidget::showEvent(QShowEvent * 이벤트).

[override virtual] QSize QWebEngineView::sizeHint() const

속성에 대한 액세스 함수를 다시 구현합니다: QWidget::sizeHint.

[slot] void QWebEngineView::stop()

문서 로드를 중지하는 편의 슬롯입니다.

에 해당합니다:

    view->page()->triggerAction(QWebEnginePage::Stop);

reload(), pageAction() 및 loadFinished()도 참조하세요 .

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

이 신호는 보기의 title 가 변경될 때마다 전송됩니다.

title()도 참조하세요 .

void QWebEngineView::triggerPageAction(QWebEnginePage::WebAction action, bool checked = false)

지정된 action 을 트리거합니다. 확인 가능한 작업인 경우 지정된 checked 상태가 가정됩니다.

다음 예는 복사 동작을 트리거하여 선택한 텍스트를 클립보드에 복사합니다.

    view->triggerPageAction(QWebEnginePage::Copy);

pageAction()도 참조하세요 .

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

이 신호는 보기의 url 가 변경될 때 발생합니다.

url() 및 load()도 참조하세요 .