Происходит непосредственно перед тем, как движок отчета начинает обрабатывать форму отчета.

PROCEDURE Object.BeforeReport

Параметры

None.

Замечания

Применяется к: ReportListener Object.

Когда Visual FoxPro вызывает событие BeforeReport для выполняемого отчета, он сделал всю необходимую подготовку для выполнения отчета. Он прочитал содержание файла определения отчета (frx) и открыл копию только для чтения этого файла в собственном сеансе (data session) для использования вашим  классом. Для получения дополнительной информации, см. FRXDataSession Property.

Перед вызовом события BeforeReport, движок отчета также создает собственный сеанс для данных отчета, если отчет определяется впервые. При этом открываются таблицы и выполняются другие задачи инициализации как определено средой данных (DataEnvironment) отчета. Для получения дополнительной информации, см. CurrentDataSession Property. Вы можете выяснить формат и данные отчета переключаясь между этими двумя сеансами данных.

В это время движок также проверил диапазон отчета, отобрав записи, которые будут обработаны при выполненнии отчета. Информация о числе записей доступна вашему коду в CommandClauses.RecordTotal. При обработке BeforeReport доступны и другие элементы CommandClauses. Для получения дополнительной информации, см. CommandClauses Property.

После окончания обработки события BeforeReport(), движок отчета готов к  выполненению отчета. Сначаля оцениваются выражения в отчете, чтобы определить, требует ли этот отчет предварительного прохода. В это время присваиваются значения дополнительным свойствам ReportListener , указывающим результат этой оценки. Для получения дополнительной информации, см.  TwoPassProcess Property и CurrentPass Property. Следом вызывается событие BeforeBand отчета.

Примечание:
Для получения дополнительной информации о порядке событий в отчете см. Understanding Visual FoxPro Object-Assisted Reporting.

Смотрите также