이 페이지에서

QWebView Class

QWebView 클래스는 웹 콘텐츠를 표시하는 데 사용되는 창을 제공합니다. 더 보기...

헤더: #include <QWebView>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebView)
target_link_libraries(mytarget PRIVATE Qt6::WebView)
qmake: QT += webview
다음부터: Qt 6.11
상속: QWindow

속성

공개 함수

bool canGoBack() const
bool canGoForward() const
QString httpUserAgentString() const
bool isLoading() const
int loadProgress() const
void runJavaScript(const QString &script, const std::function<void (const QVariant &)> &resultCallback = {})
QWebViewSettings *settings() const
QString title() const
QUrl url() const

공개 슬롯

void deleteAllCookies()
void deleteCookie(const QString &domain, const QString &name)
void goBack()
void goForward()
void loadHtml(const QString &html, const QUrl &baseUrl = QUrl())
void reload()
void setCookie(const QString &domain, const QString &name, const QString &value)
void setHttpUserAgentString(const QString &httpUserAgent)
void setUrl(const QUrl &url)
void stop()

신호

void cookieAdded(const QString &domain, const QString &name)
void cookieRemoved(const QString &domain, const QString &name)
void httpUserAgentStringChanged(const QString &userAgent)
void loadProgressChanged(int loadProgress)
void loadingChanged(const QWebViewLoadingInfo &loadingInfo)
void titleChanged(const QString &title)
void urlChanged(const QUrl &url)

재구현된 보호 함수

virtual bool event(QEvent *e) override

상세 설명

웹 뷰는 사용 가능한 플랫폼에서 네이티브 API를 사용하여 구현된 웹 콘텐츠를 표시하기 위한 창입니다. 따라서 애플리케이션의 일부로 전체 웹 브라우저 스택을 반드시 포함할 필요는 없습니다.

setUrl() 함수를 사용하여 웹 사이트를 웹 뷰에 불러올 수 있습니다.

또는 HTML 콘텐츠를 바로 사용할 수 있는 경우, 대신 setHtml()을 사용할 수 있습니다.

loadingChanged() 신호는 뷰의 로딩이 시작될 때와 뷰가 완전히 로딩되었을 때 발산됩니다. 이 신호의 인자인 QWebViewLoadRequest 객체는 로딩이 성공했는지 실패했는지를 나타냅니다.

HTML 문서의 제목은 title() 속성을 통해 확인할 수 있습니다.

속성 설명서

httpUserAgentString : QString

이 속성은 현재 사용 중인 사용자 에이전트를 저장합니다. 브라우저를 식별하기 위해 HTTP와 함께 전송되는 사용자 에이전트 문자열입니다.

액세스 함수:

QString httpUserAgentString() const
void setHttpUserAgentString(const QString &httpUserAgent)

알림 신호:

void httpUserAgentStringChanged(const QString &userAgent)

[read-only] loadProgress : int

웹 콘텐츠의 현재 로딩 진행 상황으로, 0에서 100 사이의 정수로 표시됩니다.

액세스 함수:

int loadProgress() const

알림 신호:

void loadProgressChanged(int loadProgress)

[read-only] loading : bool

WebView 가 현재 새 콘텐츠를 불러오는 중이라면 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

액세스 함수:

bool isLoading() const

알림 신호:

void loadingChanged(const QWebViewLoadingInfo &loadingInfo)

[read-only] settings : QWebViewSettings* const

QWebView 의 설정 객체. 웹 뷰에 대한 설정입니다.

액세스 함수:

QWebViewSettings *settings() const

WebViewSettings도 참조하십시오 .

title : QString

이 속성은 현재 로드된 웹 페이지의 제목을 포함합니다.

HTML의 ` <title> ` 요소에 정의된 페이지의 제목입니다.

액세스 함수:

QString title() const

알림 신호:

void titleChanged(const QString &title)

titleChanged()도 참조하십시오 .

url : QUrl

이 속성은 현재 열려 있는 웹 페이지의 URL을 저장합니다.

이 속성을 설정하면 화면이 지워지고 해당 URL이 로드됩니다. 기본적으로 이 속성에는 비어 있거나 유효하지 않은 URL이 포함됩니다. 사용자 입력에서 비롯된 URL은 ` QUrl::fromUserInput()`를 사용하여 파싱해야 합니다.

참고: ` QWebView `는 Qt 리소스 시스템을 통한 콘텐츠 로딩을 지원하지 않습니다.

액세스 함수:

QUrl url() const
void setUrl(const QUrl &url)

알림 신호:

void urlChanged(const QUrl &url)

loadingChanged()도 참조하십시오 .

멤버 함수 문서

bool QWebView::canGoBack() const

현재 웹 기록에서 뒤로 이동할 수 있는 경우 ` true `를 반환합니다.

bool QWebView::canGoForward() const

현재 웹 기록에서 앞으로 이동할 수 있는 경우 ` true `를 반환합니다.

[signal] void QWebView::cookieAdded(const QString &domain, const QString &name)

이 신호는 쿠키가 추가될 때 발생합니다.

매개변수에는 추가된 쿠키의 domain 및 name 에 대한 정보가 포함됩니다.

참고: Qt WebEngine 모듈이 백엔드로 사용되는경우 , 웹사이트에서 추가한 쿠키를 포함하여 기본 QWebEngineCookieStore 에 추가된 모든 쿠키에 대해 cookieAdded 신호가 발송됩니다. 그 외의 경우에는 setCookie()를 통해 명시적으로 추가된 쿠키에 대해서만 cookieAdded 신호가 발송됩니다.

[signal] void QWebView::cookieRemoved(const QString &domain, const QString &name)

이 신호는 쿠키가 삭제될 때 발생합니다. 매개변수에는 삭제된 쿠키의 식별자( domain )와 값( name )에 대한 정보가 포함됩니다.

[slot] void QWebView::deleteAllCookies()

모든 쿠키를 삭제합니다.

[slot] void QWebView::deleteCookie(const QString &domain, const QString &name)

지정된 domain 및 name 값을 가진 쿠키를 삭제합니다.

쿠키가 삭제되면 cookieRemoved() 신호가 발생합니다.

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

QWindow::event(QEvent *ev)를 재구현합니다.

[slot] void QWebView::goBack()

웹 기록에서 이전 페이지로 돌아갑니다.

[slot] void QWebView::goForward()

웹 기록에서 앞쪽으로 이동합니다.

[signal] void QWebView::httpUserAgentStringChanged(const QString &userAgent)

이 신호는 뷰의 ` userAgent ` 속성이 변경될 때마다 발생합니다.

참고: 속성 ` httpUserAgentString`에 대한Notifier 신호입니다.

[slot] void QWebView::loadHtml(const QString &html, const QUrl &baseUrl = QUrl())

지정된 html 콘텐츠를 웹 뷰에 불러옵니다.

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

HTML 문서에서 참조되는 스타일시트나 이미지와 같은 외부 객체는 baseUrl 을 기준으로 상대 경로에 위치해야 합니다. 예를 들어, html 이 기본 URL인 http://www.example.com/documents/overview.html 에서 불러오는 경우, 상대 URL diagram.png 으로 참조되는 이미지는 http://www.example.com/documents/diagram.png 에 위치해야 합니다.

참고: QWebView 는 Qt 리소스 시스템을 통한 콘텐츠 로딩을 지원하지 않습니다.

[signal] void QWebView::loadProgressChanged(int loadProgress)

이 신호는 웹 페이지가 로드되는 동안 지속적으로 전송됩니다. ` loadProgress ` 매개변수는 0에서 100 사이의 값으로, 웹 페이지가 몇 퍼센트 로드되었는지를 나타냅니다. 이 신호의 용도는 사용자에게 진행률 표시줄을 표시하는 것입니다.

참고: 일부 백엔드는 소수점 단위의 로딩 진행률 변화를 지원하지 않으며, 로딩 시작 시와 종료 시에만 각각 0과 100의 값으로 이 신호를 발생시킵니다.

참고: ` loadProgress` 속성에 대한알림 신호입니다.

loadingChanged도 참조하십시오 .

[signal] void QWebView::loadingChanged(const QWebViewLoadingInfo &loadingInfo)

이 신호는 웹 콘텐츠 로딩 상태가 변경될 때 발생합니다. 이 신호를 처리하면, 예를 들어 페이지 로딩 오류에 대응할 수 있습니다.

loadingInfo 매개변수에는 요청의 URL과 상태, 그리고 요청 실패 시 표시되는 오류 메시지가 담긴 errorString이 포함됩니다.

참고: loading 속성에 대한Notifier 신호입니다.

loadProgressChanged 및 QWebViewLoadingInfo도 참조하십시오 .

[slot] void QWebView::reload()

현재의 url 을 다시 불러옵니다.

void QWebView::runJavaScript(const QString &script, const std::function<void (const QVariant &)> &resultCallback = {})

지정된 자바스크립트를 실행합니다. ` resultCallback ` 함수가 제공된 경우, ` script `의 실행이 완료된 후에 해당 함수가 호출됩니다.

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

[slot] void QWebView::setCookie(const QString &domain, const QString &name, const QString &value)

지정된 domain, name 및 value 값을 가진 쿠키를 추가합니다. 쿠키가 추가되면 cookieAdded() 신호가 발생합니다.

[slot] void QWebView::stop()

현재 url 의 로딩을 중지합니다.

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

이 신호는 뷰의 title 속성이 변경될 때마다 발생합니다.

참고: 속성 ` title`에 대한알림 신호입니다.

title()도 참조하십시오 .

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

이 신호는 뷰의 url 속성이 변경될 때마다 발생합니다.

참고: 속성 ` url`에 대한Notifier 신호입니다.

url()도 참조하십시오 .

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