Настройка расширенных функций экспорта в FastReport.Web for Core и Blazor Server
Нередко у наших пользователей возникают потребности в изменении параметров экспорта файла, реализацию которых мы сегодня рассмотрим. Эта возможность появилась в релизе 2022.1. Допустим, что у нас уже есть готовый проект. Для примера возьмем любой отчет из демо-приложения FastReport .NET. Добавим к окну экспорта дополнительные параметры через этот код:
WebReport.Toolbar.Exports.EnableSettings = true;
А теперь запустим наше приложение и посмотрим на результат:
Изучим, как это работает в FastReport Web for Core более подробно.
Все параметры для расширенных настроек экспорта были реализованы с включением или выключением в зависимости всего лишь от одного параметра EnableExportSettings. Можно настроить индивидуальные варианты экспорта. Допустим нам требуется только PDF и HTML. Реализация будет выглядеть вот так:
Exports = new ExportMenuSettings() { ExportTypes = Exports.Pdf | Exports.HTML }
Немного изменим настройки экспорта в контейнере, более подробно об этом вы можете прочитать в статье Кастомизация панели инструментов и настройка экспортов в FastReport.Web for Core.
Включим расширенные настройки с помощью свойства EnableSettings, это позволит вызывать модальные окна с различными вариациями дополнительных настроек для экспорта:
WebReport.Toolbar.Exports.EnableSettings = true;
Запустим наше приложение и посмотрим на результат:
На скриншоте выше отобразились только лишь 2 формата для сохранения, также можно заметить, что есть возможность локализации на различные языки. Для использования разных языков нужно написать небольшую строчку кода:
webReport.LocalizationFile = Path.Combine(Directory.GetCurrentDirectory(),"Localization", "English.frl");
Но как же экспортировать файл с расширенными настройками? Рассмотрим это пошагово.
Шаг 1. Нажимаем на шестеренку напротив “Экспорт в PDF”, где у нас должно появиться следующее окно:
Шаг 2. Выбираем параметры, которые нам нужны, например, HTML файл без картинок:
Шаг 3. Нажимаем ОК и смотрим на полученный результат:
Если не отображаются картинки, значит мы всё сделали верно.
Нельзя не упомянуть, что существует возможность кастомизации окна настроек. Давайте рассмотрим, как это сделать. Для начала напишем несколько строчек кода:
WebReport.Toolbar.Exports.Color = Color.Gray; WebReport.Toolbar.Exports.FontSettings = new Font("Times New Roman", 14, FontStyle.Bold);
Посмотрим, что произошло:
Можно заметить, что установился цвет серый и семейство шрифтов Times New Roman, как и было указано.
На данном этапе мы рассмотрели, как использовать расширенные настройки экспортов для FastReport.Web for Core.
Теперь продемонстрируем вам работу в Blazor. Опять же обозревать будем на одном из доступных отчётов. Для примера возьмем демо-приложение из нашей статьи Кастомизация панели инструментов и настройка экспортов и добавим в него новые возможности. Вновь добавим расширенные настройки и всевозможные экспорты. К слову, здесь тоже есть кастомизация и используется она аналогично, как и в Core. Заходим в файл Pages/Index.razor.cs и пишем две строчки кода:
webReport.Toolbar.Exports = ExportMenuSettings.All; webReport.Toolbar.Exports.EnableSettings = true;
Запускаем наше приложение:
Мы видим, что все экспорты отображаются и расширенные настройки к ним тоже. Поэкспериментируем с расширенными возможностями экспорта в “HTML”. Для этого открываем настройки кликом левой кнопки мыши по шестеренке, где, для примера, оставим только текущую страницу с картинками:
Подтверждаем свой выбор кнопкой “ОК” и смотрим на результат:
По итогу мы с вами рассмотрели, как использовать расширенные настройки экспортов для FastReport.Web for Core и Blazor Server через код вашего приложения.
