Тип QML WebEngineDownloadItem
Предоставляет информацию о загружаемом файле. Подробнее...
| Заявление об импорте: | import QtWebEngine 1.5 |
| С момента: | QtWebEngine 1.1 |
Свойства
- id : int
- interruptReason : перечисление
- interruptReasonString : строка
- mimeType : строка
- path : строка
- receivedBytes : int
- savePageFormat : перечисление
- state : перечисление
- totalBytes : int
- type : перечисление
Методы
Подробное описание
Хранит состояние загрузки для управления запрошенными загрузками.
По умолчанию загрузка отклоняется, пока пользователь явно не подтвердит её с помощью accept().
Документация по свойствам
id : int
Содержит идентификатор элемента загрузки.
[только для чтения] interruptReason : перечисление
Возвращает причину прерывания загрузки:
| Постоянная | Описание |
|---|---|
WebEngineDownloadItem.NoReason |
Неизвестная причина или загрузка не прервана. |
WebEngineDownloadItem.FileFailed |
Общее системное повреждение файла. |
WebEngineDownloadItem.FileAccessDenied |
Файл не может быть сохранён локально из-за ограничений доступа. |
WebEngineDownloadItem.FileNoSpace |
Недостаточно места на целевом диске. |
WebEngineDownloadItem.FileNameTooLong |
Имя файла или каталог слишком длинные. |
WebEngineDownloadItem.FileTooLarge |
Размер файла превышает ограничение файловой системы. |
WebEngineDownloadItem.FileVirusInfected |
Файл заражён вирусом. |
WebEngineDownloadItem.FileTransientError |
Временная проблема (например, файл используется, недостаточно памяти или одновременно открыто слишком много файлов). |
WebEngineDownloadItem.FileBlocked |
Файл заблокирован из-за локальной политики. |
WebEngineDownloadItem.FileSecurityCheckFailed |
Проверка безопасности загрузки завершилась ошибкой по непредвиденным причинам. |
WebEngineDownloadItem.FileTooShort |
Попытка перейти за пределы файла при открытии (например, при возобновлении ранее прерванной загрузки). |
WebEngineDownloadItem.FileHashMismatch |
Частичный файл не соответствует ожидаемой контрольной сумме. |
WebEngineDownloadItem.NetworkFailed |
Общее сетевое повреждение. |
WebEngineDownloadItem.NetworkTimeout |
Сеансу сетевого запроса истекло время ожидания. |
WebEngineDownloadItem.NetworkDisconnected |
Сеть была разорвана. |
WebEngineDownloadItem.NetworkServerDown |
Сервер не работает. |
WebEngineDownloadItem.NetworkInvalidRequest |
Некорректный сетевой запрос (например, URL недействителен, поддерживает недопустимый протокол или запрещён политикой). |
WebEngineDownloadItem.ServerFailed |
Общее повреждение сервера. |
WebEngineDownloadItem.ServerBadContent |
Сервер не имеет запрашиваемых данных. |
WebEngineDownloadItem.ServerUnauthorized |
Сервер не авторизовал доступ к ресурсу. |
WebEngineDownloadItem.ServerCertProblem |
Произошла проблема с сертификатом сервера. |
WebEngineDownloadItem.ServerForbidden |
Доступ запрещён сервером. |
WebEngineDownloadItem.ServerUnreachable |
Непредвиденный ответ сервера (может указывать на то, что сервер ответа не является ожидаемым). |
WebEngineDownloadItem.UserCanceled |
Пользователь отменил загрузку. |
Это свойство QML было добавлено в QtWebEngine 1.5.
См. также interruptReasonString.
interruptReasonString : строка
Возвращает удобочитаемое описание причины прерывания загрузки.
Это свойство QML было добавлено в QtWebEngine 1.5.
См. также interruptReason.
mimeType : строка
Содержит MIME-тип загрузки.
Это свойство QML было добавлено в QtWebEngine 1.2.
path : строка
Содержит полный целевой путь, куда загружаются данные.
Путь включает имя файла. Предлагаемый по умолчанию путь — стандартное место для загрузок, имя файла определяется так, чтобы не перезаписывать уже существующие файлы.
Путь к загружаемому файлу можно установить только в обработчике WebEngineProfile.onDownloadRequested перед подтверждением загрузки.
См. также WebEngineProfile::downloadRequested() и accept().
receivedBytes : int
Содержит количество загруженных данных в байтах.
savePageFormat : перечисление
Описывает формат сохранения веб-страницы.
| Постоянная | Описание |
|---|---|
WebEngineDownloadItem.UnknownSaveFormat |
Это не запрос на загрузку полной веб-страницы. |
WebEngineDownloadItem.SingleHtmlSaveFormat |
Страница сохраняется как единственный HTML-файл. Ресурсы, такие как изображения, не сохраняются. |
WebEngineDownloadItem.CompleteHtmlSaveFormat |
Страница сохраняется как полная HTML-страница, например, каталог, содержащий единственную HTML-страницу и ресурсы. |
WebEngineDownloadItem.MimeHtmlSaveFormat |
Страница сохраняется как полная веб-страница в формате MIME HTML. |
Это свойство QML было добавлено в QtWebEngine 1.3.
state : перечисление
Описывает состояние загрузки:
| Постоянная | Описание |
|---|---|
WebEngineDownloadItem.DownloadRequested |
Загрузка запрошена, но ещё не подтверждена. |
WebEngineDownloadItem.DownloadInProgress |
Загрузка выполняется. |
WebEngineDownloadItem.DownloadCompleted |
Загрузка успешно завершена. |
WebEngineDownloadItem.DownloadCancelled |
Загрузка отменена пользователем. |
WebEngineDownloadItem.DownloadInterrupted |
Загрузка прервана (сервером или из-за потери подключения). |
totalBytes : int
Содержит общий размер загружаемых данных в байтах.
-1 означает, что общий размер неизвестен.
[только для чтения] type : перечисление
Описывает тип запрашиваемой загрузки.
| Постоянная | Описание |
|---|---|
WebEngineDownloadItem.Attachment |
Ответ веб-сервера включает заголовок Content-Disposition с директивой attachment. Если Content-Disposition присутствует в ответе, веб-сервер указывает клиенту запросить сохранение содержимого независимо от его типа. См. RFC 2616 раздел 19.5.1 для получения подробной информации. |
WebEngineDownloadItem.DownloadAttribute |
Пользователь нажал на ссылку с атрибутом download. См. атрибут загрузки HTML для получения подробной информации. |
WebEngineDownloadItem.UserRequested |
Пользователь инициировал загрузку, например, выбрав веб-действие. |
WebEngineDownloadItem.SavePage |
Запрошено сохранение текущей страницы (например, веб-действием WebEngineView.SavePage). |
Это свойство QML было добавлено в QtWebEngine 1.4.
Документация по методам
void accept()
Принимает запрос на загрузку, что запустит её.
void cancel()
Отменяет загрузку.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtwebengine-webenginedownloaditem.html
