Бэнды

Печатная форма представляет собой «отчет» с набором элементов, описывающих то, как должен выглядеть готовый отчет. Для группировки элементов по их расположению в готовом отчете применяются бэнды (англ. band - лента, полоска). Все элементы, описывающие форму, должны находится в бэндах. Бэнды разделяются на два вида: служебные (заголовок отчета, страницы и пр.) и дата-бэнды, образующие многострочную часть отчета. Дата-бэнды подключаются к источникам данных, и их содержимое выводится столько раз, сколько имеется строк данных в источнике.

Виды бэндов:

Служебный:

Band (TGBRepBand) - используется для создания шапки, подвала и колонтитулов.

Параметры:

Имя - используется для идентификации. Например для указания порядка печати;

Шрифт - шрифт текста. Используется в элементах, расположенных в бэнде, если у них не указан свой шрифт;

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

Делать копию для работы - делать копию источника данных при работе. Используется, если создаются переменные в указанном источнике;

Тип представления - вид представления данных при печати. Существует несколько типов:

Custom - настраиваемый тип, т.е. вид каждой строки настраивается по своему усмотрению;

DSVisible Fields - печатать только поля со свойством Visible, шапка создается;

Fields Collection - выбрать и настроить поля для печати;

Get from Grid - взять данные из таблицы, указанной в поле "Таблица".

Варианты обрисовки бэнда - обрисовка бэнда тонкой сплошной линией черного цвета. Вокруг, сверху, снизу, справа, слева;

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

Column Header - заголовок колонки;

Detail - список строк, MasterBand и DetailBand имеют этот тип по умолчанию всегда;

Detail Summary - итоги списка;

Page Footer - разделитель страницы (отображается внизу каждой страницы);

Page Header - заголовок страницы (отображается сверху на каждой странице);

Summary - итоги. Располагается и печатается после DetailBand или MasterBand, игнорируется, если указано свойство «Родительский бэнд»;

Title - заголовок. Используется для печати шапки, подвала, итогов печатной формы.

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

Цвет фона бэнда - цвет фона бэнда при печати;

Родительский бэнд - имя бэнда, после которого будет напечатан текущий бэнд, столько раз, сколько будет напечатан родительский;

Переменные - список переменных, используемых в текущем бэнде или других с тем же источником данных или генерируемым при печати на основе источника в текущем бэнде;

Перед печатью - скрипт, который будет выполняться перед печатью данного бэнда;

После печати - скрипт, который будет выполняться после печати данного бэнда;

Дата-бэнды:

MasterBand (TGBMasterBand) - используется для печати уже сгруппированных и многоуровневых данных, как элемент, отображающий данные первого уровня. Основные свойства совпадают со свойствами Band-а, описанного выше, кроме:

Тип бэнда - всегда Detail (недоступен для редактирования);

Авто cуммирование - считать итоги по колонкам у которых стоит свойство «суммирование»;

DetailBand для мастера/Detail: - используется при многоуровневой печати с использованием принципа Master-Detail, для чего в МастерБэнде указывается ссылка на детайл, а в ДетайлБэнде указывается свойство, что он подчиненный («Есть главный Бэнд»);

Подпись к финальным итогам - подпись к итогам. В случае использования связки Master-Detail у ДетайлБэнда так же могут быть итоги (по группе). Эта же подпись выводится в самом конце, подводя общие итоги по колонкам. Так же можно указать шрифт итогов. Если шрифт специально не указан, то используется шрифт, указанный для бэнда;

Итоги по СТРАНИЦЕ - свойство означает, что в случае печати данных, которые не умещаются на одну страницу в конце каждой страницы будут выводиться итоги по напечатанным на ней данным;

С новой страницы - в случае использования связки Master-Detail каждый новый МастерБэнд отобразится с начала новой страницы. То есть например, каждая группа будет начинаться с новой страницы;

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

DetailBand (TGBDetailBand) - используется для печати одноуровневых данных, или как подчиненный, при печати сгруппированных данных (Master-Detail). Основные свойства совпадают со свойствами Band-а, описанного выше за исключеникм следующих:

Сквозная нумерация - используется если ДетайлБэнд является подчиненным МастерБэнду. Если свойство включено, то номера строк будут монотонно возрастать, иначе номера будут начинаться с 1 после печати очередного МастерБэнд-а;

Генерировать шапку таблицы - выводить шапку таблицы или нет. Используется в паре с типами представления Fields Collection, Get from Grid. Так же можно указать шрифт выводимого заголовка. Варианты вывода заголовка:

Нумерация колонок - использовать ли нумерацию колонок. При печати строк детайла на следующей странице будут выводиться вместо шапки будут выводиться номера колонок;

Поместить после мастера - в случае печати связки Master-Detail если это свойство не стоит, то печатается заголовок детайла потом Мастер потом строки ДетайлБэнда. Иначе - МастерБэнд, Заголовок ДетайлБэнда, строки ДетайлБэнда;

Есть главный Бэнд - признак, что текущий ДетайлБэнд является подчиненным у МастерБэнда;

С новой страницы - выводить бэнд с начала новой страницы. То есть здесь каждая строка на новой странице;

Номера строк - выводить автоматически номера строк в первой колонке указанной ширины. Используется только с типом представления Fields Collection;

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

Фильтровать по переменным - список полей, переменных по которым будет производиться фильтрование исходных данных;

Колонки - настройки колонок для типа представления Fields Collection. Настраиваются подпись, поле, суммирование, шрифт,ш ирина колонки;

Мин. количество строк - минимальное количество строк, выводимых на страницу. Используется для того, чтобы избежать ситуации, когда на последней странице выводятся только итоги или подвал формы;

Бэнд перед шапкой - имя бэнда, который будет выводится перед шапкой ДетайлБэнда. Сам бэнд в Печатной Форме должен располагаться перед ДетайлБэндом;

Бэнд после шапки - имя бэнда, который будет выводится сразу после шапки ДетайлБэнда, перед строками. Сам бэнд в Печатной Форме должен располагаться перед ДетайлБэндом;

Бэнд перед итогами - имя бэнда, который будет выводится после последней строки ДетайлБэнда перед итогами;

GroupMasterBand (TGBGroupBand) - используется для построения группированных данных из предоставленных данных для печати. Возможна многоуровневая группировка. Свойства аналогичны MasterBand.

GroupDetailBand (TGBDetailGroupBand) - подчиненный элемент при печати сгруппированных данных.Основные свойства совпадают со свойствами DetailBand-а, описанного выше, кроме:

Группировать по полям - имя поля или переменной, по которой будет производится группировка.

Примечание: если для GroupMasterBand-а выбран тип представления Fields Collection, Get from Grid, то свойство Генерировать шапку таблицы так же можно использовать.

Для размещения данных на бэндах используются следующие элементы:

Метка (TGBReportLabel) - Текстовое поле.

Параметры:

Авто-размер - ширина и высота элемента при печати будет увеличена в соответствии с размером текста и шрифта;

Выравнивание - выравнивание содержимого относительно элемента: Влево, Вправо, По центру;

Шрифт - шрифт текста, если не указан, используется шрифт бэнда, на котором расположен элемент;

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

Межстрочный интервал – задает интервал между строками (появился в версии ГБ 1.7.0.99). 1 соответствует одинарному интервалу, 2 - двойному и т.д.

Поле (TGBReportDBText) - Поле из источника данных или выражение.

Некоторые параметры схожи с параметрами элемента Метка за исключением следующих:

Источник - источник данных. Если не указан, используется источник бэнда, на котором расположен элемент;

Поле - поле из источника или выражение с использованием функций ГБ;

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

Линия (TGBReportShape) - геометрическая фигура, прямоугольник.

Параметры:

Вертикальные линии - в поле задаются координаты вертикальных линий через ";" относительно левого края данного элемента;

Горизонтальные линии - задаются координаты горизонтальных линий через ";" относительно верхнего края данного элемента;

Вид границы - вид линии;

Ширина границы - ширина линии границы, в пикселах. Ширина, высота точки равны примерно четверти миллиметра;

Цвет заливки - цвет заливки элемента;

Цвет границы - цвет линии границы.

Системная инф-ция (TGBReportSysinfo) - служебная информация при печати.

Картинка (TGBReportImage) - на закладке графика необходимо указать путь к файлу-изображению, после сохранения формы файл будет внедрен в ПФ.

Штрих-код (TGBReportDBBarcode) - поле из источника данных или выражение, возвращающее числовое представление штрих кода.

Параметры, отличные от параметров предыдущих элементов:

Поле - поле из источника или выражение в формате ГБ;

Выводить цифры - отображать цифры штрих-кода;

Автоопределение типа - авотматически определять тип штрих-кода по значению поля;

Тип - задание типа штрих-кода.