Интерфейс

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

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

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

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

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

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

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

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

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

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

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

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

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

Главное меню

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

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

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

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

Меню «Файл»

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

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

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

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

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

Данные

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

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

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

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

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

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

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

Дерево объектов

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

Позволяет:

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

Панель вкладок

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

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

Элементы

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

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

Стандартная

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

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

Текст

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

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

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

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

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

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

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

Разметка

Стиль

Полигон

Панель группировки

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

Панель группировки (Group Editor) - позволяет визуально настраивать, как данные будут группироваться и повторяться в отчете.

Row Groups (Группы строк)

Определяют вертикальную структуру отчета.

Каждая добавленная сюда группа заставляет соответствующие строки таблицы или табликса повторяться для каждого уникального значения поля группировки.

Column Groups (Группы столбцов)

Определяют горизонтальную структуру (актуально для табликсов).

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

Панель слоев

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

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

Верхняя панель (иконки)

• Зеленый плюс (+) — добавить новый слой в отчет.
• Черный крестик (x) — удалить выбранный слой (слой default удалить нельзя).
• Иконка с одним желтым квадратом на первом плане — перемещение выбранного слоя выше.
• Иконка с двумя белыми квадратами на первом плане — перемещение выбранного слоя ниже.

Колонки в таблице слоев

• Layer (Слой) - название слоя. Выделенная синим строка (в данном случае default) указывает на активный слой. Все новые элементы, добавляемые на холст, будут привязаны именно к нему.
• Visibility (Видимость) - управляет свойством Designer Visible. Если галочка снята, все элементы этого слоя станут невидимыми в дизайнере, что удобно при работе с многослойными макетами.
• Lock (Блокировка) - управляет свойством Designer Lock. При активации элементы этого слоя нельзя будет случайно переместить или изменить их размер мышкой на холсте.
• Field Selector Availability (Доступность выбора полей) - включает или отключает выпадающий список выбора полей (Field Selector) для текстовых полей (TextBox), принадлежащих этому слою. По умолчанию эта функция включена.

Основные правила работы

• Можно редактировать свойства или положение только тех объектов, которые находятся на текущем активном слое.
• Слой default создается автоматически, его невозможно переименовать или удалить.

Холст

Внимание!
Это описание - для старой версии дизайнера документов (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.ИмяМетода().