Обработка событий PreviewControl.OnPrint и .OnExport

01.10.2020

В FastReport 2019.4 добавилась возможность подписки на события PreviewControl.OnPrint и PreviewControl.OnExport, которые вызываются непосредственно при нажатии соответствующих кнопок.

При просмотре отчета вызывается viewer с панелью инструментов, на которой есть такие элементы как кнопка печати и выпадающий список с экспортами отчета. Выбрав какой-либо элемент списка сработает событие OnExport, а нажав на кнопку Print – OnPrint. Давайте на примере рассмотрим, как можно использовать эти события на практике.

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

 OnExport event setted

В этом случае вы просто добавляете нужные вам действия в обработчик.

Но, если вы добавляете компонент PreviewControl в коде приложения, то придется подписать собственный обработчик на событие. Например, ваш обработчик может отправлять оповещение о событии экспорта или печати. Это может быть, например, запись в базу данных. Рассмотрим этот пример:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
 private void Button1_Click(object sender, EventArgs e)
 {
 //create report
 Report report = new Report();
 //Load report
 report.Load("App_Data/Master-Detail.frx");
 //create data source
 DataSet data = new DataSet();
 //load data
 data.ReadXml("C:\\Program Files (x86)\\FastReports\\FastReport.Net\\Demos\\Reports\\nwind.xml");
 //register data
 report.RegisterData(data);
 //create preview object
 var prev = new PreviewControl();
 //add preview into the form
 this.Controls.Add(prev);
 prev.Dock = DockStyle.Fill;
 prev.BringToFront();
 //subscribe to the event
 prev.OnExport+= new System.EventHandler<PreviewControl.ExportEventArgs>(ExportAction);
 //assign preview control to the report
 report.Preview = prev;
 //Show the report
 report.Show();
 }

После создания объекта отчета и регистрации данных в нем, мы создаем PreviewControl, подписываем на событие OnExport свой обработчик события, который реализуем ниже. Далее, мы присваиваем объект PreviewControl preview отчета. А теперь реализуем пользовательский обработчик события OnExport:

1
2
3
4
5
6
7
8
9
 public void ExportAction(object sender, PreviewControl.ExportEventArgs e)
 {
 SqlConnection conn = new SqlConnection(@"Data Source=.\SQLEXPRESS;Initial Catalog=usersdb;Integrated Security=True");
 SqlCommand command = new SqlCommand("insert into dbo.Status (ReportName, ExportType, ExportDate) Vales ('" + Path.GetFileNameWithoutExtension(e.Report.FileName) + "', '"+ e.Export.BaseName +"', '" + DateTime.Now + "')");
 command.Connection = conn;
 conn.Open();
 command.ExecuteNonQuery();
 conn.Close();
 }

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

Аналогичным образом реализуется работа с событием OnPrint.

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

.NET FastReport Preview .NET FastReport Preview
13 октября 2025

Как использовать Excel формулы в отчете при экспорте в MS Excel

Начиная с версии FastReport .NET 2026.1 появилась возможность экспортировать формулы в Microsoft Excel. Важно правильно настроить экспорт формул и соблюдать синтаксис.
13 октября 2025

Новые возможности экспорта изображений в Microsoft Word в FastReport .NET

В последней версии FastReport .NET мы добавили новые функции экспорта изображений. Теперь можно самостоятельно настроить баланс между качеством и размером итогового документа.
30 сентября 2025

Как установить дизайнер отчетов FastReport .NET с предустановленными плагинами

Читайте в статье как с версии 2025.2.5 для FastReport .NET WinForms и FastReport .NET WEB можно установить дизайнер отчётов со всеми плагинами без сборки dll-файлов.

Не является публичной офертой
© 1998-2025 ООО «Быстрые отчеты»