Подмена стандартного окна прогресса
Окно прогресса показывается при выполнении следующих операций:
- построение отчета;
- печать;
- экспорт.
Вы можете отключить окно прогресса, установив значение свойства FastReport.Utils.Config.ReportSettings.ShowProgress
в false
.
Вы также можете подключить собственное окно прогресса. Для этого используйте следующие события, которые определены в классе FastReport.Utils.Config.ReportSettings
(см. раздел "Конфигурация среды FastReport"):
Событие | Описание |
---|---|
StartProgress |
Вызывается один раз перед началом операции. В этом событии нужно создать свое окно прогресса и показать его. |
Progress |
Вызывается каждый раз после обработки очередной страницы отчета. В этом событии нужно показать текущее состояние прогресса. |
FinishProgress |
Вызывается один раз после окончания операции. В этом событии нужно разрушить свое окно прогресса. |
В событие Progress
передается параметр e
типа ProgressEventArgs
. Он имеет следующие свойства:
Тип, свойство | Описание |
---|---|
string Message |
Текст сообщения. |
int Progress |
Номер текущей обрабатываемой страницы. |
int Total |
Общее количество страниц. Этот параметр может быть равен 0, если выполняется построение отчета, так как в этом случае общее количество страниц неизвестно. |
Как правило, в обработчике события Progress
достаточно показать текст, который передан в параметре e.Message
, в собственном окне прогресса.