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

Одним из способов расширения функциональности отчётов является обработка событий, которые генерируются при работе пользователя с отчётом.

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

обрабатывать ввод данных «на лету»;
выводить диалог подтверждения выполняемого действия;
выполнять дополнительные действия перед и/или после возникновения какого-либо события;
выводить информационные сообщения, содержащие определённую информацию (например, идентификатор изменённого элемента управления, тип гиперссылки).

Для регламентных отчётов можно настроить обработку событий, происходящих:

перед открытием регламентного отчёта;
перед и после смены активного листа регламентного отчёта;
перед и после вычисления области данных (в том числе, реляционной), регламентного отчёта целиком или его отдельного листа;
перед и после печати и экспорта регламентного отчёта;
перед и после сохранения изменённых значений областей данных;
при изменении значения элемента управления регламентного отчёта;
перед сохранением регламентного отчёта и др.

Основное назначение подключения прикладных макросов и обработчиков событий:

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

Сигнатура указываемого макроса может содержать параметры.

Работа с событиями отчёта

Для подключения модуля обработки событий нажмите кнопку «Подключить модуль» на вкладке «Разработка» ленты инструментов. Будет открыт диалог выбора объектов репозитория.

Для работы с обработчиком событий нажмите кнопку «Обработка событий», расположенную на вкладке «Разработка» ленты инструментов, и выберите одно из действий:

Создать обработчик событий. Будет открыто окно создания модуля Fore.
Отключить обработчик событий. Подключённый модуль обработки событи будет отключён.

Для настройки обработки событий нажмите кнопку , расположенную в правом нижнем углу группы кнопок «Модули» на вкладке «Разработка» ленты инструментов. Откроется окно «Модули отчета и обработка событий», содержащее вкладки:

Модули. Предназначена для работы со списком объектов, доступных для использования в регламентном отчёте;
Обработка событий. Предназначена для работы с обработчиками событий.

См. также:

Начало работы с инструментом «Отчёты» в веб-приложении | Визуализация данных в виде диаграмм