Pascal Scripting: CreateDownloadPage

Прототип

function CreateDownloadPage(const ACaption, ADescription: String; const OnDownloadProgress: TOnDownloadProgress): TDownloadWizardPage;

Описание

Выполняет создание страницы для мастера установки, которая позволяет загружать файлы из различных источников в сети Интернет и показывает прогресс загрузки.

Для параметра OnDownloadProgress укажите функцию, которая будет передавать информацию о ходе загрузки, или значение nil, если в этом нет необходимости.

Для параметра ACaption следует указать заголовок страницы, а для параметра ADescription краткое описание назначения страницы.

В отличии от других типов страниц мастера установки, страницы с индикатором выполнения не отображаются как часть обычной последовательности страниц (обратите внимание, что параметр AfterID отсутствует). Страницу с индикатором выполнения можно отобразить только программно, путём вызова метода Show.

Комментарии

Вызов метода Show активирует и отображает страницу. Завершив с ней работу, сделайте вызов метода Hide, чтобы вернуться на предыдущую страницу.

Всегда указывайте вызов Hide внутри раздела finally конструкции try..finally, как показано в файле примера CodeDownloadFiles.iss. Отсутствие вызова Hide приведёт к тому, что мастер установки навсегда застрянет на странице выполнения.

Чтобы добавить новый файл для загрузки, используйте вызов метода Add. А перед добавлением первого файла всегда используйте вызов метода Clear.

Чтобы начать загрузку, используйте вызов метода Download. В случае ошибки будет вызвано исключение. Иначе Download вернёт количество загруженных байт.

Установите для свойства ShowBaseNameInsteadOfUrl значение True, чтобы вместо URL-адреса отображалось исходное имя загружаемого файла.

В описании функции DownloadTemporaryFile вы найдете дополнительные сведения по классу TOnDownloadProgress.

Пример

Смотрите файл CodeDownloadFiles.iss из папки "Examples" в каталоге установки Inno Setup.

См. также:

TDownloadWizardPage
DownloadTemporaryFile
CreateOutputProgressPage