Диалоговое окно состояния (Status Dialog)

Диалоговое окно состояния (Status Dialog) в AutoPlay Media Studio является диалоговым окном Windows, содержащим индикатор выполнения и некоторые дополнительные элементы, например кнопку Отмена (Cancel), значок-иконку, текст заголовка и текст состояния. Оно было разработан, чтобы позволить дополнительно отображать графическое представление процесса выполнения действия автозапуска или любого другого элемента в проекте. Пример диалогового окна можно увидеть ниже:

Существует несколько действий в AutoPlay Media Studio, которые автоматически используют это диалоговое окно для отображения процесса своего выполнения (конечно, если вы хотите показать его):

File.Copy
File.Delete
File.Find
File.Install
File.Move
Folder.DeleteTree
Folder.Find
HTTP.Download
HTTP.DownloadSecure
HTTP.GetFileSize
HTTP.GetFileSizeSecure
Zip.Add
Zip.Extract

Каждое вышеуказанное действие автоматически отправляет информацию о ходе выполнения в диалоговое окно состояния (Status Dialog) для отображения его в индикаторе выполнения (прогресс-баре). По умолчанию, диалоговое окно состояния (Status Dialog) скрыто, но можно показать его запустив перед действием (где нужно показать выполнение), действие StatusDlg.Show, а после выполнения действия, действие StatusDlg.Hide. Действие StatusDlg.Show используется для показа диалогового окна состояния (Status Dialog), а действие StatusDlg.Hide используется для сокрытия его, обычно после того, как действие закончит работу. Можно найти другие доступные действия в категории действия StatusDlg.

Для данной группы действий, эта функциональность обрабатывается автоматически, тем не менее имеется возможность переопределить её. Каждое действие содержит параметр, называемый CallbackFunction. По умолчанию параметр CallbackFunction установлен в значение nil. Это означает, что действие будет автоматически передавать сведения о ходе выполнения в диалоговое окно состояния (Status Dialog). Однако в некоторых случаях может понадобиться дополнительный контроль над тем, что и как оно отображает. В этой ситуации можно провести функцию как параметр функции обратного вызова (CallbackFunction) (нужно будет учитывать действие, используемое для требуемых параметров функции). Можно найти пример, иллюстрирующий этот способ в статье Создать заказную функцию обратного вызова (Callback Function).

До этого момента, диалоговое окно состояния (Status Dialog) описывалось в связи с конкретными действиями в AutoPlay Media Studio. Однако, благодаря своей гибкости и возможности, оно может быть использоватно во множестве других направлений. Диалоговое окно состояния (Status Dialog) содержит свою собственную категорию действий, называющуюся StatusDlg и может использоваться для обеспечения отображения процесса выполнения любого требуемого типа. Можно найти пример этого в статье Использование диалогового окна состояния.

Смотрите также: Связанные действия