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

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

Материал из Химсофт Вики
Строка 45: Строка 45:
==Обработчики событий==
==Обработчики событий==


Скрипт главным образом используется для создания обработчиков событий объектов. Для создания обработчика события выделите нужный объект. В окне "Свойства" нажмите кнопку [[Файл: event_btn.png|border]], чтобы переключиться на список событий:
===Создание обработчика события===
*выделить нужный объект;
*в окне <code>Свойства</code> нажать кнопку [[Файл: event_btn.png|border]], чтобы переключиться на список событий:


[[Файл: event_handler_1.png|border|center]]
[[Файл: event_handler_1.png|border|center]]


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


<syntaxhighlight lang="C#">
private void Text2_BeforePrint(object sender, EventArgs e)
private void Text2_BeforePrint(object sender, EventArgs e)
{
{


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


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


[[Файл: event_handler_2.png|border|center]]
[[Файл: event_handler_2.png|border|center]]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Создание обработчика события

  • выделить нужный объект;
  • в окне Свойства нажать кнопку , чтобы переключиться на список событий:
  • выбрать интересующее событие и сделать на нем двойной щелчок мышью - дизайнер добавит в код отчета пустой обработчик события:
private void Text2_BeforePrint(object sender, EventArgs e)
{

}

Объект Отчет также имеет события.

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

  • выбрать Report в окне Дерево отчета;
  • выбрать Report в выпадающем списке объектов окна Свойства.

Чтобы удалить обработчик события:

  • выбрать событие в окне Свойства;
  • выделить текст имени события и нажамть клавишу Delete:

События

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

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

Объекты Report и Engine

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

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

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

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