QWebEngineLoadingInfo Class
WebEngineView::loadingChanged 信号的实用程序类型。更多
| 头文件： | #include <QWebEngineLoadingInfo> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake： | QT += webenginecore |
| 自 | Qt 6.2 |
| 在 QML 中： | WebEngineLoadingInfo |
公共类型
| enum | ErrorDomain { NoErrorDomain, InternalErrorDomain, ConnectionErrorDomain, CertificateErrorDomain, HttpErrorDomain, …, HttpStatusCodeDomain } |
| enum | LoadStatus { LoadStartedStatus, LoadStoppedStatus, LoadSucceededStatus, LoadFailedStatus } |
属性
|
|
公共功能
| int | errorCode() const |
| QWebEngineLoadingInfo::ErrorDomain | errorDomain() const |
| QString | errorString() const |
| bool | isDownload() const |
| bool | isErrorPage() const |
| QMultiMap<QByteArray, QByteArray> | responseHeaders() const |
| QWebEngineLoadingInfo::LoadStatus | status() const |
| QUrl | url() const |
另请参阅 QWebEnginePage::loadStarted,QWebEnginePage::loadFinished, 和WebEngineView::loadingChanged 。
成员类型文档
enum QWebEngineLoadingInfo::ErrorDomain
该枚举表示加载错误的类型：
| 常量 | 值 | 说明 |
|---|---|---|
QWebEngineLoadingInfo::NoErrorDomain | 0 | 错误类型未知。 |
QWebEngineLoadingInfo::InternalErrorDomain | 1 | Qt WebEngine 无法解释内容。 |
QWebEngineLoadingInfo::ConnectionErrorDomain | 2 | 网络连接故障导致错误。 |
QWebEngineLoadingInfo::CertificateErrorDomain | 3 | 错误与 SSL/TLS 证书有关。 |
QWebEngineLoadingInfo::HttpErrorDomain | 4 | 错误与 HTTP 连接有关。 |
QWebEngineLoadingInfo::FtpErrorDomain | 5 | 错误与 FTP 连接有关。 |
QWebEngineLoadingInfo::DnsErrorDomain | 6 | 错误与 DNS 连接有关。 |
QWebEngineLoadingInfo::HttpStatusCodeDomain | 7 | 错误是 HTTP 响应状态代码，即使在成功的情况下，例如服务器回复状态为 200。 |
enum QWebEngineLoadingInfo::LoadStatus
该枚举表示网页加载请求的加载状态：
| 常量 | 值 | 说明 |
|---|---|---|
QWebEngineLoadingInfo::LoadStartedStatus | 0 | 页面正在加载。 |
QWebEngineLoadingInfo::LoadStoppedStatus | 1 | 页面加载被 stop() 方法或 Chromium 中的加载器代码或网络协议栈停止。 |
QWebEngineLoadingInfo::LoadSucceededStatus | 2 | 页面已成功加载。 |
QWebEngineLoadingInfo::LoadFailedStatus | 3 | 页面无法加载。 |
属性文档
[read-only] errorCode : const int
保存错误代码。
访问功能：
| int | errorCode() const |
[read-only] errorString : const QString
保存错误信息。
访问功能：
| QString | errorString() const |
[read-only, since 6.9] isDownload : const bool
表示页面加载是否在内部停止（QWebEngineLoadingInfo::status() 等于QWebEngineLoadingInfo::LoadStoppedStatus ），并将作为下载请求继续。
此属性在 Qt 6.9 中引入。
访问函数：
| bool | isDownload() const |
[read-only] isErrorPage : const bool
表示加载是否导致错误页面。
访问功能：
| bool | isErrorPage() const |
[read-only, since 6.6] responseHeaders : const QMultiMap<QByteArray,QByteArray>
当QWebEngineLoadingInfo::status() 等于QWebEngineLoadingInfo::LoadSucceededStatus 或QWebEngineLoadingInfo::LoadFailedStatus 时，保留响应标头。
此属性在 Qt 6.6 中引入。
访问函数：
| QMultiMap<QByteArray, QByteArray> | responseHeaders() const |
[read-only] status : const LoadStatus
该属性显示页面的加载状态。
访问功能：
| QWebEngineLoadingInfo::LoadStatus | status() const |
[read-only] url : const QUrl
保存加载请求的 URL。
访问函数：
| QUrl | url() const |
© 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.
