Класс QWebEngineDownloadItem

Класс QWebEngineDownloadItem предоставляет информацию о загрузке. Подробнее...

Заголовок:	#include <QWebEngineDownloadItem>
qmake:	QT += webenginewidgets
С момента:	Qt 5.5
Наследует:	QObject

Список всех членов, включая унаследованные

Открытые типы

перечисление	DownloadInterruptReason { НетПричин, ОшибкаФайла, ОтказВДоступеКФайлу, НетМестаНаДиске, ..., ОтменаПользователем }
перечисление	DownloadState { ЗапросЗагрузки, ЗагрузкаВПроцессе, ЗагрузкаЗавершена, ЗагрузкаОтменена, ЗагрузкаПрервана }
перечисление	DownloadType { Вложение, АтрибутЗагрузки, ЗапросПользователя, СохранитьСтраницу }
перечисление	SavePageFormat { НеизвестныйФорматСохранения, ФорматСохраненияSingleHtml, ФорматСохраненияCompleteHtml, ФорматСохраненияMimeHtml }

Открытые функции

quint32	id() const
DownloadInterruptReason	interruptReason() const
QString	interruptReasonString() const
bool	isFinished() const
QString	mimeType() const
QString	path() const
qint64	receivedBytes() const
SavePageFormat	savePageFormat() const
void	setPath(QString path)
void	setSavePageFormat(SavePageFormat format)
DownloadState	state() const
qint64	totalBytes() const
DownloadType	type() const
QUrl	url() const

32 открытых функции унаследованы от QObject

Открытые слоты

void	accept()
void	cancel()

1 открытый слот унаследован от QObject

Сигналы

void	downloadProgress(qint64 bytesReceived, qint64 bytesTotal)
void	finished()
void	stateChanged(QWebEngineDownloadItem::DownloadState state)

2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

1 свойство унаследовано от QObject
11 статические открытые члены унаследованы от QObject
9 защищенные функции унаследованы от QObject

Подробное описание

Класс QWebEngineDownloadItem предоставляет информацию о загрузке.

QWebEngineDownloadItem хранит состояние загрузки для управления запрошенными загрузками.

Документация по типам членов

перечисление QWebEngineDownloadItem::DownloadInterruptReason

Описывает причину прерывания загрузки:

Постоянная	Значение	Описание
`QWebEngineDownloadItem::NoReason`	`0`	Неизвестная причина или прерывание не произошло.
`QWebEngineDownloadItem::FileFailed`	`1`	Ошибка общей работы с файлом.
`QWebEngineDownloadItem::FileAccessDenied`	`2`	Файл не может быть записан локально из-за ограничений доступа.
`QWebEngineDownloadItem::FileNoSpace`	`3`	Недостаточно места на целевом диске.
`QWebEngineDownloadItem::FileNameTooLong`	`5`	Имя каталога или файла слишком длинное.
`QWebEngineDownloadItem::FileTooLarge`	`6`	Размер файла превышает ограничение файловой системы.
`QWebEngineDownloadItem::FileVirusInfected`	`7`	Файл заражён вирусом.
`QWebEngineDownloadItem::FileTransientError`	`10`	Временная проблема (например, файл используется, недостаточно памяти или одновременно открыто слишком много файлов).
`QWebEngineDownloadItem::FileBlocked`	`11`	Файл заблокирован из-за локальной политики.
`QWebEngineDownloadItem::FileSecurityCheckFailed`	`12`	Попытка проверки безопасности загрузки завершилась неудачно по непредвиденным причинам.
`QWebEngineDownloadItem::FileTooShort`	`13`	Попытка перехода за пределы конца файла при открытии файла (как часть возобновления ранее прерванной загрузки).
`QWebEngineDownloadItem::FileHashMismatch`	`14`	Частичный файл не соответствует ожидаемой хеш-сумме.
`QWebEngineDownloadItem::NetworkFailed`	`20`	Ошибка общей сети.
`QWebEngineDownloadItem::NetworkTimeout`	`21`	Сеть превысила время ожидания.
`QWebEngineDownloadItem::NetworkDisconnected`	`22`	Соединение с сетью прервано.
`QWebEngineDownloadItem::NetworkServerDown`	`23`	Сервер вышел из строя.
`QWebEngineDownloadItem::NetworkInvalidRequest`	`24`	Запрос в сеть был некорректным (например, исходный или перенаправленный URL некорректен, имеет неподдерживаемую схему или запрещён политикой).
`QWebEngineDownloadItem::ServerFailed`	`30`	Ошибка общего характера на сервере.
`QWebEngineDownloadItem::ServerBadContent`	`33`	Запрашиваемые данные отсутствуют на сервере.
`QWebEngineDownloadItem::ServerUnauthorized`	`34`	Сервер не авторизовал доступ к ресурсу.
`QWebEngineDownloadItem::ServerCertProblem`	`35`	Произошла проблема с сертификатом сервера.
`QWebEngineDownloadItem::ServerForbidden`	`36`	Доступ запрещён сервером.
`QWebEngineDownloadItem::ServerUnreachable`	`37`	Неожиданный ответ сервера (может указывать, что сервер, который ответил, не является целевым сервером).
`QWebEngineDownloadItem::UserCanceled`	`40`	Пользователь отменил загрузку.

Этот перечисление был добавлен или изменён в Qt 5.9.

enum QWebEngineDownloadItem::DownloadState

Это перечисление описывает состояние загрузки:

Постоянная	Значение	Описание
`QWebEngineDownloadItem::DownloadRequested`	`0`	Загрузка запрошена, но ещё не принята.
`QWebEngineDownloadItem::DownloadInProgress`	`1`	Загрузка в процессе.
`QWebEngineDownloadItem::DownloadCompleted`	`2`	Загрузка завершена успешно.
`QWebEngineDownloadItem::DownloadCancelled`	`3`	Загрузка отменена.
`QWebEngineDownloadItem::DownloadInterrupted`	`4`	Загрузка прервана (сервером или из-за потери соединения).

enum QWebEngineDownloadItem::DownloadType

Описывает тип запрошенной загрузки.

Постоянная	Значение	Описание
`QWebEngineDownloadItem::Attachment`	`0`	Ответ веб-сервера содержит заголовок `Content-Disposition` с директивой `attachment`. Если `Content-Disposition` присутствует в ответе, веб-сервер указывает, что клиент должен запросить сохранение содержимого независимо от типа содержимого. Подробности см. в разделе 19.5.1 RFC 2616.
`QWebEngineDownloadItem::DownloadAttribute`	`1`	Пользователь нажал на ссылку с атрибутом `download`. Подробности см. в атрибуте HTML download.
`QWebEngineDownloadItem::UserRequested`	`2`	Пользователь инициировал загрузку, например, выбрав веб-действие.
`QWebEngineDownloadItem::SavePage`	`3`	Запрошено сохранение текущей страницы (например, с помощью веб-действия QWebEnginePage::SavePage).

Это перечисление было добавлено или изменено в Qt 5.8.

enum QWebEngineDownloadItem::SavePageFormat

Это перечисление описывает формат, используемый для сохранения веб-страницы.

Постоянная	Значение	Описание
`QWebEngineDownloadItem::UnknownSaveFormat`	`-1`	Это не запрос на загрузку полной веб-страницы.
`QWebEngineDownloadItem::SingleHtmlSaveFormat`	`0`	Страница сохраняется как единая HTML-страница. Ресурсы, такие как изображения, не сохраняются.
`QWebEngineDownloadItem::CompleteHtmlSaveFormat`	`1`	Страница сохраняется как полная HTML-страница, например, каталог, содержащий единую HTML-страницу и ресурсы.
`QWebEngineDownloadItem::MimeHtmlSaveFormat`	`2`	Страница сохраняется как полная веб-страница в формате MIME HTML.

Это перечисление было добавлено или изменено в Qt 5.7.

Документация по функциям-членам

`[slot]` void QWebEngineDownloadItem::accept()

Принимает текущий запрос на загрузку, что начнёт загрузку.

См. также finished() и stateChanged().

`[slot]` void QWebEngineDownloadItem::cancel()

Отменяет текущую загрузку.

См. также finished() и stateChanged().

`[signal]` void QWebEngineDownloadItem::downloadProgress(qint64 bytesReceived, qint64 bytesTotal)

Этот сигнал генерируется для указания хода загрузки запроса.

Параметр bytesReceived указывает количество полученных байтов, а bytesTotal — общее количество ожидаемых загружаемых байтов. Если размер загружаемого файла неизвестен, bytesTotal будет равен 0.

См. также totalBytes() и receivedBytes().

`[signal]` void QWebEngineDownloadItem::finished()

Этот сигнал генерируется всякий раз, когда загрузка завершается.

См. также state() и isFinished().

quint32 QWebEngineDownloadItem::id() const

Возвращает идентификатор элемента загрузки.

DownloadInterruptReason QWebEngineDownloadItem::interruptReason() const

Возвращает причину прерывания загрузки.

Эта функция была добавлена в Qt 5.9.

См. также interruptReasonString().

QString QWebEngineDownloadItem::interruptReasonString() const

Возвращает удобочитаемое описание причины прерывания загрузки.

Эта функция была добавлена в Qt 5.9.

См. также interruptReason().

bool QWebEngineDownloadItem::isFinished() const

Возвращает значение, указывающее, завершена ли эта загрузка (не находится ли в процессе).

См. также finished() и state().

QString QWebEngineDownloadItem::mimeType() const

Возвращает тип MIME загрузки.

Эта функция была добавлена в Qt 5.6.

QString QWebEngineDownloadItem::path() const

Возвращает полный целевой путь, куда загружаются данные.

Путь включает имя файла. Предлагаемый по умолчанию путь — стандартное место для загрузки, а имя файла выводится таким образом, чтобы не перезаписывать уже существующие файлы.

См. также setPath().

qint64 QWebEngineDownloadItem::receivedBytes() const

Возвращает количество загруженных данных в байтах.

-1 означает, что размер неизвестен.

SavePageFormat QWebEngineDownloadItem::savePageFormat() const

Возвращает формат, в котором будет сохранена веб-страница, если это запрос на загрузку веб-страницы.

Эта функция была добавлена в Qt 5.7.

См. также setSavePageFormat().

void QWebEngineDownloadItem::setPath(QString path)

Устанавливает полный целевой путь для загрузки файла.

path также должен содержать имя файла. Путь к загружаемому файлу можно задать только в ответ на сигнал QWebEngineProfile::downloadRequested() перед подтверждением загрузки. После этого момента эта функция не оказывает влияния на состояние элемента загрузки.

См. также path().

void QWebEngineDownloadItem::setSavePageFormat(SavePageFormat format)

Устанавливает формат, в котором будет сохранена веб-страница, если это запрос на загрузку веб-страницы.

Эта функция была добавлена в Qt 5.7.

См. также savePageFormat().

DownloadState QWebEngineDownloadItem::state() const

Возвращает текущее состояние элемента загрузки.

См. также DownloadState.

`[signal]` void QWebEngineDownloadItem::stateChanged(QWebEngineDownloadItem::DownloadState state)

Этот сигнал подаётся всякий раз, когда меняется состояние загрузки.

См. также state() и DownloadState.

qint64 QWebEngineDownloadItem::totalBytes() const

Возвращает общий объём данных для загрузки в байтах.