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

Scripts: различия между версиями

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


==Обработчики событий==
==Обработчики событий==
Скрипт главным образом используется для создания обработчиков событий объектов. Для создания обработчика события выделите нужный объект. В окне "Свойства" нажмите кнопку [[Файл: event_btn.png|border]], чтобы переключиться на список событий:
[[Файл: event_handler_1.png|border|center]]
Выберите интересующее вас событие и сделайте на нем двойной щелчок мышью. FastReport добавит в код отчета пустой обработчик события:
private void Text2_BeforePrint(object sender, EventArgs e)
{
}
Объект "Отчет" также имеет события. Выбрать этот объект можно следующими способами:
выберите "Report" в окне "Дерево отчета";
выберите "Report" в выпадающем списке объектов окна "Свойства".
Чтобы удалить обработчик события, выберите событие в окне "Свойства", выделите текст имени события и нажмите клавишу Delete:
[[Файл: event_handler_2.png|border|center]]
==События==
==События==
==Обращение к объектам .NET==
==Обращение к объектам .NET==

Версия от 01:23, 20 октября 2026

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

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

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

Область применения вкладки Код довольно обширна - она позволяет:

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

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

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

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

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

Вкладка Код в дизайнере содержит только то, что написано вами.

Во вкладке можно

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

Во вкладке нельзя

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

Порядок действий дизайнера при запуске отчета

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

Обработчики событий

Скрипт главным образом используется для создания обработчиков событий объектов. Для создания обработчика события выделите нужный объект. В окне "Свойства" нажмите кнопку , чтобы переключиться на список событий:

Выберите интересующее вас событие и сделайте на нем двойной щелчок мышью. FastReport добавит в код отчета пустой обработчик события:

private void Text2_BeforePrint(object sender, EventArgs e) {

} Объект "Отчет" также имеет события. Выбрать этот объект можно следующими способами:

выберите "Report" в окне "Дерево отчета"; выберите "Report" в выпадающем списке объектов окна "Свойства". Чтобы удалить обработчик события, выберите событие в окне "Свойства", выделите текст имени события и нажмите клавишу Delete:

События

Обращение к объектам .NET

Обращение к объектам отчета

Объекты Report и Engine

Обращение к источникам данных

Обращение к системным переменным

Обращение к итоговым значениям

Обращение к параметрам отчета