Интерфейс

Для работы в Дизайнере документов используются два окна:

Приветственное окно
Основное окно

Приветственное окно

Приветственное окно - стартовое окно для работы с шаблонами документов, которое разделено на две функциональные зоны:

панель основных действий (слева)
список истории (справа)

Панель основных действий

Новый шаблон - Команда для создания абсолютно нового бланка или формы «с нуля».
Открыть шаблон с компьютера - Позволяет выбрать файл шаблона, который уже сохранен в памяти вашего ПК или на флешке.
Открыть шаблон из базы - Загрузка шаблона из общего сетевого хранилища или встроенной библиотеки программы.

Список истории

Недавние - Список файлов, с которыми осуществлялась работа в последнее время.

Основное окно

Основное окно утилиты "Дизайнер документов" имеет следующие блоки элементов интерфейса:

1 - Главное меню
2 - Вкладки
3 - Панель инструментов
4 - Данные / Дерево отчета
5 - Панель объектов отчета

6 - Структура бэндов
7 - Макет отчёта
8 - Свойства объектов
9 - Скрипт / Закладки страниц и диалоговых форм
10 - Панель масштабирования макета отчёта

Главное меню

Главное меню - типовое меню с перечнем основных команд для работы с документами.

Справа от названий команд указаны «горячие клавиши» (сочетания клавиш на клавиатуре), которые позволяют выполнять эти действия мгновенно, не заходя в меню.

Слева расположены иконки, визуально облегчающие поиск нужной функции.

Состоит из разделов: Файл, Параметры и Помощь.

Меню «Файл»

Новая вкладка (Ctrl+N) - создает новую вкладку;
Новый шаблон отчёта (Ctrl+Alt+N) - создает новый шаблон отчета;
Открыть (Ctrl+O) - позволяет выбрать и загрузить уже существующий файл с диска;
Сохранить (Ctrl+S) - перезаписывает текущий открытый файл с внесенными изменениями;
Сохранить как... (Ctrl+Alt+S) - сохраняет копию файла под новым именем или в другую папку;
Выход (Alt+F4) - завершение работы программы.

Меню «Параметры»

Параметры - открывает диалоговое окно настройки подключений.

Меню «Помощь»

О программе - содержит основные сведения о программном продукте.

Вкладки

Вкладки - используются для быстрого переключения между несколькими открытыми шаблонами.

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

Элементы

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

Панель инструментов

Это служебное меню позволяет включать и выключать отображение нужных панелей на рабочем пространстве.

Внимание!

При выключении всех разделов панели меню - вся панель пропадает и ее невозможно вернуть даже при перезагрузке программы!

Стандартная

Содержит кнопки для управления структурой отчета и файлами (слева направо):

Новый отчет — создание чистого бланка или выбор мастера шаблонов;
Открыть отчет — загрузка ранее сохраненного файла отчета (.fr3);
Сохранить отчет — запись текущих изменений в файл;
Просмотр (Preview) — запуск отчета на выполнение для просмотра готового результата с данными;
Параметры / Источники данных — настройка подключения к базам данных и выбор таблиц;
Новая страница отчета — добавление дополнительной вкладки (страницы) в текущий шаблон;
Новая страница диалога — создание формы диалога для ввода параметров перед формированием отчета;
Удалить страницу — удаление текущей выбранной страницы из шаблона;
Параметры страницы — настройка размеров листа, полей (отступов) и ориентации (альбомная/книжная);
Вырезать — удаление выделенного объекта с сохранением его в буфер обмена;
Копировать — копирование выделенного объекта в буфер обмена;
Вставить — добавление объекта из буфера обмена на страницу;
Копирование формата (Формат по образцу) — перенос стилей оформления (шрифт, цвет, рамки) с одного объекта на другой;
Отменить — отмена последнего выполненного действия в редакторе
Повторить — возврат отмененного действия.

Текст

Предназначена для оформления текстовых полей (объектов «Memo»):

Выбор шрифта (на скриншоте Arial) — изменение гарнитуры и семейства шрифта;
Размер шрифта (на скриншоте 10) — изменение размера (кегля) букв;
B (Bold / Полужирный) — делает текст жирным;
I (Italic / Курсив) — делает текст наклонным;
U (Underline / Подчеркнутый) — добавляет нижнее подчеркивание текста;
Горизонтальное выравнивание (блок из 4 кнопок):

По левому краю;
По центру;
По правому краю;
По ширине (растягивание текста по границам блока);

Вертикальное выравнивание (блок из 3 кнопок):

По верхнему краю;
По центру (вертикально);
По нижнему краю;

Цвет текста — выбор цвета букв из палитры;
Цвет заливки — выбор цвета фона внутри текстового контейнера;
Поворот текста — изменение угла наклона текста (0, 90, 180, 270 градусов).

Рамка и заливка

Отвечает за отрисовку табличных границ и внешнего вида ячеек:

Все границы — включает отображение рамки со всех четырёх сторон объекта;
Верхняя граница — включает/выключает только верхнюю линию;
Нижняя граница — включает/выключает только нижнюю линию;
Левая граница — включает/выключает только левую вертикальную линию;
Правая граница — включает/выключает только правую вертикальную линию;
Без границ — полностью убирает все контуры вокруг объекта;
Тень — добавляет декоративное смещение (эффект объемной тени) для объекта;
Цвет рамки (иконка с карандашом) — открывает палитру для изменения цвета линий контура;
Стиль заливки (иконка с текстурой) — позволяет выбрать тип заполнения (сплошной цвет, градиент или штриховка);
Стиль линии (выпадающее меню) — выбор типа линии (сплошная, пунктирная, штриховая и т.д.);
Толщина линии (выпадающее меню) — регулировка ширины линий рамки в пикселях.

Разметка

Эта панель используется для точного взаимного выравнивания, распределения и изменения размеров группы выделенных объектов (кнопки сгруппированы по назначению слева направо):

Сетка и привязка:

Выравнивать по сетке — принудительно сдвигает объекты так, чтобы их углы совпадали с узлами координатной сетки;
Привязать к сетке — включает режим «магнита», при котором объекты при перемещении автоматически притягиваются к сетке;

Выравнивание сторон (относительно первого выделенного объекта):

По левому краю — выравнивает левые границы всех выделенных объектов по одной линии;
По правому краю — выравнивает правые границы объектов
По верхнему краю — выравнивает объекты по их верхней границе;
По нижнему краю — выравнивает объекты по их нижней границе;
По центру горизонтально — центрирует объекты по их вертикальной оси;
По центру вертикально — центрирует объекты по их горизонтальной оси;

Подгонка размеров (приведение к одному размеру):

Одинаковая ширина — делает все выделенные объекты такими же по ширине, как и эталонный (первый выделенный);
Одинаковая высота — делает объекты равными по высоте;
Одинаковый размер — одновременно делает объекты одинаковыми и по ширине, и по высоте;

Распределение (выравнивание промежутков между объектами):

Распределить по горизонтали — делает одинаковые расстояния (просветы) между объектами в ряду;
Распределить по вертикали — делает одинаковые расстояния между объектами в столбце;

Центрирование на странице:

Центрировать по горизонтали на странице — перемещает объект(ы) строго в центр листа по горизонтали;
Центрировать по вертикали на странице — перемещает объект(ы) строго в центр листа по вертикали;

Шаг и сдвиг (ручная доводка):

Позволяют сдвигать или изменять размер объектов на один пиксель (или шаг сетки) в разные стороны.

Стиль

Используется для быстрого применения готового оформления к текстовым и графическим блокам:

Выпадающий список (Select style) — позволяет выбрать один из заранее созданных стилей (например, стиль для заголовков, четных/нечетных строк таблиц). Стиль может включать в себя настройки шрифта, цвета, заливки и рамок.
Редактор стилей (иконка с листом и карандашом) — открывает диалоговое окно для создания, удаления или изменения пользовательских стилей текущего отчета.

Внимание!

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

На этапе применения стиля проблем не возникает.

На этапе редакции элемента с примененным стилем элемент "запоминает" настройки стиля и не меняет их. Для смены параметра приходится выставлять стиль в положение "Нет стиля".

Полигон

Эта панель становится активной при работе со сложным графическим объектом «Полигон» (многоугольник) и служит для редактирования его формы по точкам:

Перемещение объекта / Указатель — стандартный режим выбора и переноса всего полигона целиком;
Добавить точку — позволяет кликом мыши поставить новую вершину на контуре многоугольника для усложнения его формы;
Редактировать линии (Режим кривых / Безье) — переключает тип соединительных линий между точками (прямые линии или сглаженные кривые);
Изменить направление контура / Отразить — инвертирует порядок обхода точек многоугольника;
Удалить точку — удаляет выделенную вершину (узел) с контура геометрической фигуры.

Данные

Окно "Данные" - позволяет:

управлять всеми элементами данных;
вставлять элементы данных в отчет путем перетаскивания их на страницу отчета.

Окно содержит:

разделы Системные переменные, Итоги, Параметры и Функции - доступны по умолчанию при открытии новой вкладки;
раздел Источники данных - появляется только после создания источника данных (подключения к БД).

Все операции с элементами окна выполняются с помощью панели инструментов и меню "Действия":

Часть этих операций дублируется в контекстном меню элементов окна "Данные".

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

Дерево отчета

Дерево отчета - панель с древовидной структурой, которая служит центром управления всеми элементами отчета.

Позволяет:

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

Панель объектов отчета

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

Структура бэндов

Бэнд (англ. band – полоска) – это объект, который размещается непосредственно на странице отчета и является контейнером для остальных объектов, таких, как Текст, Рисунок и прочих.

Для использования доступно 13 типов бэндов.

Холст

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Холст (рабочее поле, дизайнер макета) - визуальный редактор, предназначенный для размещения элементов управления и настройки структуры отчета.

Основные компоненты рабочего поля

Сетка - фоновая разметка, которая помогает точно позиционировать элементы; параметры сетки (шаг, привязка) можно настроить для удобства выравнивания объектов.
Линейки - расположены сверху и слева от рабочего поля; используются для измерения размеров элементов и установки отступов.
Секции - в стандартном макете поле разделено на логические области; по умолчанию создается секция ReportSection1 и отображается кнопка для создания новой вкладки New.
Page Header и Page Footer - содержимое, которое повторяется в начале и конце каждой страницы.
Detail - основная область данных, которая дублируется для каждой записи из источника.

Взаимодействие

Перетаскивание - элементы управления (текстовые поля, таблицы, графики) переносятся из панели инструментов прямо на рабочее поле.

Нижняя панель

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Нижняя панель (строка состояния, панель режимов) - содержит инструменты для переключения рабочих пространств и управления визуализацией макета.

Вкладки режимов работы (кнопки слева)

Designer - основной визуальный редактор, где проектируется структура отчета.
Script - окно для написания программного кода на VB.NET, который позволяет динамически изменять данные или оформление в процессе генерации отчета.
Preview - режим предварительного просмотра, отображающий отчет с реальными данными (наподобие того, как он будет выглядеть при печати или экспорте).

Группа инструментов визуализации (центральные кнопки)

Dimension Lines (размерные линии) - отображает вспомогательные линии с размерами отступов и расстояний между элементами при их перемещении.
Hide Grid (скрыть сетку) - полностью отключает отображение сетки на рабочем поле.
Show Dots (показать точки) - отображает сетку в виде отдельных точек на пересечении линий.
Show Lines (показать линии) - отображает сетку в виде сплошных горизонтальных и вертикальных линий.
Snap Lines (привязка к линиям) - включает/выключает направляющие, которые помогают выравнивать элементы относительно границ других объектов.
Snap to Grid (привязка к сетке) - заставляет границы элементов автоматически «примагничиваться» к узлам сетки при перемещении или изменении размера.
Select Mode (режим выделения) - стандартный режим курсора, позволяющий выбирать, перемещать и редактировать элементы макета.
Pan Mode (режим панорамирования) - инструмент «Рука», позволяющий быстро перемещаться (прокручивать) по рабочему полю, «захватывая» его мышью.

Инструмент масштабирования (справа)

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

Числовое значение (например, 130%)
Ползунок с кнопками + и – .

Preview

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Когда пользователь нажимает кнопку Preview (Предварительный просмотр), открывается окно предварительного просмотра.

Окно предварительного просмотра состоит из следующих управляющих элементов.

Боковая панель в WEB-браузере

Search - открывает панель для поиска любого слова или фразы.
Export - открывает панель экспорта отчета в различные форматы (pdf, xlsx, xls, docx, tiff, mht, csv, json, xml).
Parameters - открывает панель выбора параметров, доступных для данного шаблона отчета.

Верхняя панель в WEB-браузере

First Page - переход на первую страницу отчета.
Previous Page - переход на предыдущую страницу. Номер страницы: переход на указанную страницу отчета.
Next Page - переход на следующую страницу.
Last Page - переход на последнюю страницу отчета.
Refresh - обновление отчета.
Back - вернуться к дизайнеру.
Backward - переход на страницу, с которой вы открыли отчет до текущей страницы.
Forward - переход на страницу, с которой вы открыли текущую страницу.
Move tool - навигация по отчету с помощью перетаскивания вверх или вниз.
Zoom Support - изменяет масштаб области проектирования с помощью кнопок увеличения + и уменьшения - или сочетаний клавиш [Ctrl] + [+] для увеличения и [Ctrl] + [-] для уменьшения.
Toggle Fullscreen - полноэкранный режим.
Print - вывод отчета на печать.
Single Page - отображается одна страница отчета за раз.
Continuous - отображаются все страницы отчета друг под другом.
Galley - отображаются отчеты RDLX без автоматических разрывов страниц, данные отображаются на одной странице с возможностью прокрутки.

Верхняя панель в дизайнере документов

Toggle Sidebar - включение/выключение отображения боковой панели Page thumbnails.
Print - вывод отчета на печать.
Galley mode - отображаются отчеты RDLX без автоматических разрывов страниц, данные отображаются на одной странице с возможностью прокрутки.
Copy - копировать.
Find - открывает окно поиска, в котором можно найти любое слово или фразу.
Zoom Support - изменяет масштаб области проектирования с помощью кнопок увеличения + и уменьшения - или сочетаний клавиш [Ctrl] + [+] для увеличения и [Ctrl] + [-] для уменьшения.
Fit width - масштабирование ширины страницы отчета по ширине рабочей области дизайнера.
Fit page - масштабирование высоты страницы отчета по высоте рабочей области дизайнера.
Single page view - отображается одна страница отчета за раз.
Continuous view - отображаются все страницы отчета друг под другом.
Multipage view - отображает несколько страниц в табличном формате.
First page - переход на первую страницу отчета.
Previous page - переход на предыдущую страницу. Номер страницы: переход на указанную страницу отчета.
Next page - переход на следующую страницу.
Last page - переход на последнюю страницу отчета.
Backward - переход на страницу, с которой вы открыли отчет до текущей страницы.
Forward - переход на страницу, с которой вы открыли текущую страницу.
Back to parent report - вернуться к основному отчету.
Refresh - обновление отчета.
Pan mode - навигация по отчету с помощью перетаскивания вверх или вниз.
Selection mode - выберите элемент(ы) отчета.
Snapshot mode - скриншот экрана в буфер обмена.

Script

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Script (скрипт) - предназначена для написания логики на языках VB.NET, которая сохраняется непосредственно внутри файла определения отчета.

Основные возможности и назначение

Автономность отчетов - скрипты позволяют создавать «самодостаточные» отчеты. В отличие от стандартного подхода с использованием «code-behind» (файлов .vb или .cs), код во вкладке Script компилируется в момент выполнения отчета, что позволяет изменять логику без пересборки всего приложения.
Событийно-ориентированная модель - скрипты привязываются к конкретным событиям отчета или его секций. Для этого в редакторе предусмотрены выпадающие списки Object (объект) и Event (событие).
Управление данными и макетом - через скрипты можно динамически изменять свойства элементов (например, скрывать поля, менять цвет текста), выполнять расчеты или программно подключать источники данных.

Работа с объектами и событиями

Во вкладке Script доступны следующие ключевые элементы управления:

Object (объекты) - можно выбрать сам отчет (Report) или конкретные секции (например, Detail, PageHeader, GroupFooter).
Event (события) - список событий зависит от выбранного объекта.
Для секций часто используются: Format (подготовка данных), BeforePrint и AfterPrint.
Для отчета в целом: ReportStart, DataInitialize, FetchData и ReportEnd.

Особенности использования VB.NET

Синтаксис - используется стандартный синтаксис VB.NET.
Типы отчетов - скрипты на VB.NET поддерживаются как в Section Reports, так и в Page/RDLX Reports.
Интеграция с выражениями - в Page-отчетах методы, написанные во вкладке Script, можно вызывать напрямую из свойств контролов через конструкцию =Code.ИмяМетода().