Перейти к содержанию

Scripts

Материал из Химсофт Вики

Скрипт – это программа на языке высокого уровня, которая является частью отчета.

Скрипт может быть написан на одном из языков .NET:

  • C# (предпочтительно);
  • VisualBasic.NET (нежелательно).

Область применения скрипта довольно обширна. Используя скрипт, вы можете сделать следующее:

  • выполнить обработку данных, которую невозможно сделать штатными средствами ядра дизайнера;
  • управлять печатью страниц отчета и бэндов на странице;
  • управлять взаимодействием элементов управления на диалоговых формах;
  • управлять формированием динамических объектов Таблица;
  • и многое другое.

Чтобы увидеть скрипт отчета, переключитесь на закладку Код в дизайнере:

Язык скрипта настраивается в меню Отчет|Свойства....

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

Общая информация

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

  • добавлять в главный класс скрипта свои переменные, методы, свойства;
  • создавать обработчики событий объектов отчета;
  • добавлять новые классы в скрипт, если это необходимо. Класс может быть добавлен как перед главным классом ReportScript, так и после него.

Вы не можете:

  • удалять, переименовывать или изменять область видимости главного класса ReportScript;
  • переименовывать пространство имен, в котором находится главный класс.

При запуске отчета происходит следующее:

  • FastReport добавляет в скрипт список переменных, имена которых совпадают с именами объектов отчета. Это делается перед компиляцией скрипта и позволяет вам обращаться к объектам отчета по их имени;
  • в скрипт добавляются выражения, имеющиеся в отчете, в виде функций;
  • выполняется компиляция скрипта, если он не пустой;
  • инициализируются переменные, которые были неявно добавлены в скрипт;
  • обработчики событий, определенные в скрипте, привязываются к объектам отчета;
  • запускается отчет.