이 페이지에서

QWebView Class

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

Header: #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
QWebViewSettings *settings() const
QString title() const
QUrl url() const

공용 슬롯

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

신호

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 을 반환합니다.

[slot] void QWebView::deleteAllCookies()

모든 쿠키를 삭제합니다.

[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 속성에 대한 알림 신호입니다.

httpUserAgent()도 참조하세요 .

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

loadProgressChangedQWebViewLoadingInfo참조하세요 .

[slot] void QWebView::reload()

현재 url 를 다시 로드합니다.

[slot] void QWebView::stop()

현재 url 로드를 중지합니다.

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

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

참고: 속성에 대한 알림 신호 title.

title()도 참조하세요 .

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

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

참고: 속성에 대한 알림 신호 url.

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.