# Элементы шаблона KugarTemplate

Полосы разделов | Элементы секции
`ReportHeader` | `Line`
`PageHeader` | `Label`
`DetailHeader` | `Field`
`Detail` | `CalculatedField`
`DetailFooter` | `Special`
`PageFooter` | Нижний колонтитул
`ReportFooter` | Итоги секции

## Секции `ReportHeader` и `ReportFooter`

Элементы `ReportHeader` и `ReportFooter` определяют секции отчёта, которые обычно печатаются в начале и конце отчёта.

    <!ELEMENT ReportHeader (Line*, Label*, Special*)>
    <!ATTLIST ReportHeader
         Height          CDATA #REQUIRED
         PrintFrequency  CDATA #REQUIRED>

    <!ELEMENT ReportFooter (Line*, Label*, Special*, CalculatedField*)>
    <!ATTLIST ReportFooter
         Height         CDATA #REQUIRED
         PrintFrequency CDATA #REQUIRED>

Атрибуты

- `Height`

- Устанавливает высоту секции отчёта, если вы этого, секция устанавливает это значение в `0`.

`PrintFrequency`

- Устанавливает частоту печати секции.

  Значение | Частота печати
  `0` | Первая страница
  `1` | Каждая страница
  `2` | Последняя страница

## Секции `PageHeader` и `PageFooter`

Элементы `PageHeader` и `PageFooter` определяют секции отчёта, которые обычно печатаются на каждой странице отчёта.

    <!ELEMENT PageHeader (Line*, Label*, Special*)>
    <!ATTLIST PageHeader
         Height          CDATA #REQUIRED
         PrintFrequency  CDATA #REQUIRED>

    <!ELEMENT PageFooter (Line*, Label*, Special*)>
    <!ATTLIST PageFooter
         Height          CDATA #REQUIRED
         PrintFrequency  CDATA #REQUIRED>

Атрибуты

- `Height`

- Устанавливает высоту секции отчёта, если вы этого, секция устанавливает это значение в `0`.

`PrintFrequency`

- Устанавливает частоту печати секции.

  Значение | Частота печати
  `0` | Первая страница
  `1` | Каждая страница
  `2` | Последняя страница

## Секции `DetailHeader` и `DetailFooter`

Элементы `DetailHeader` и `DetailFooter` определяют секции отчёта, которые печатаются перед и после секции указанного уровня и ниже отчёте.

    <!ELEMENT DetailHeader (Line*, Label*, Special*)>
    <!ATTLIST DetailHeader
         Height          CDATA #REQUIRED
         Level           CDATA #REQUIRED>

    <!ELEMENT DetailFooter (Line*, Label*, Special*)>
    <!ATTLIST DetailFooter
         Height          CDATA #REQUIRED
         Level           CDATA #REQUIRED>

Атрибуты

- `Height`

- Устанавливает высоту секции отчёта, если вы этого, секция устанавливает это значение в `0`.

`Level`

- Установить уровень иерархии раздела. Разделы с более высоким уровнем будут напечатаны перед разделами с более низким. Уровень может быть любым числом начиная с 0.

## Секция `Секция`

Элемент `Секция` определяет секцию отчёта, которая содержит его данные. Отчёт может содержать несколько секций, которые ассоциированы с атрибутом уровень секции.

    <!ELEMENT Detail (Line*,  Label*, Special*, Field*)>
    <!ATTLIST Detail
         Height  CDATA   #REQUIRED
         Level   CDATA   #REQUIRED>

Атрибуты

- `Height`

- Устанавливает высоту секции отчёта, если вы этого, секция устанавливает это значение в `0`.

`Level`

- Установить для секции уровень иерархии. Секции с более высоким уровнем будут напечатаны перед секциями с более низким. Уровень может быть любым числом начиная с 0. Это является атрибутом элемента `строка` в файле данных.

## `Line`

Элемент `Линия` определяет объект отчёте используемый для рисования линий.

    <!ELEMENT Line EMPTY>
    <!ATTLIST Line
         X1     CDATA #REQUIRED
         Y1     CDATA #REQUIRED
         X2     CDATA #REQUIRED
         Y2     CDATA #REQUIRED
         Width  CDATA #REQUIRED
         Color  CDATA #REQUIRED
         Style  CDATA #REQUIRED>

Атрибуты

- `X1`

- Устанавливает для линии координату начала x (относительно верхнего левого угла секции).

`Y1`

- Устанавливает для линии координату начала y (относительно верхнего левого угла секции).

`X2`

- Устанавливает для линии координату окончания x (относительно верхнего левого угла секции).

`Y2`

- Устанавливает для линии координату окончания y (относительно верхнего левого угла секции).

`Width`

- Установить для линии длину.

`Color`

- Установить цвет линии. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`Style`

- Установить для линии тип рисунка

  Значение | Стиль линии
  `0` | Нет линии
  `1` | Непрерывная
  `2` | Тире
  `3` | Точка
  `4` | Тире точка
  `5` | Тире точка точка

## `Label`

Элемент `Метка` определяет объект отчёта, используемый для вывода фиксированного текста.

    <!ELEMENT Label EMPTY>
      <!ATTLIST Label
         Text            CDATA #REQUIRED
         X               CDATA #REQUIRED
         Y               CDATA #REQUIRED
         Width           CDATA #REQUIRED
         Height          CDATA #REQUIRED
         BackgroundColor CDATA #REQUIRED
         ForegroundColor CDATA #REQUIRED
         BorderColor     CDATA #REQUIRED
         BorderWidth     CDATA #REQUIRED
         BorderStyle     CDATA #REQUIRED
         FontFamily      CDATA #REQUIRED
         FontSize        CDATA #REQUIRED
         FontWeight      CDATA #REQUIRED
         FontItalic      CDATA #REQUIRED
         HAlignment      CDATA #REQUIRED
         VAlignment      CDATA #REQUIRED
         WordWrap        CDATA #REQUIRED>

Атрибуты

- `Text`

- Установить для метки текст.

`X`

- Устанавливает для метки координату начала x (относительно верхнего левого угла секции) для её позиционирования.

`Y`

- Устанавливает для метки координату начала y (относительно верхнего левого угла секции) для её позиционирования.

`Width`

- Установить для метки длину.

`Height`

- Установить для метки высоту.

`BackgroundColor`

- Установить цвет фона для метки. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`ForegroundColor`

- Установить цвет метки. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`BorderColor`

- Установить цвет границы для метки. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`BorderWidth`

- Установить для метки толщину границы.

`BorderStyle`

- Установить для метки тип границы.

  Значение | Стиль границы
  `0` | Нет
  `1` | Непрерывная
  `2` | Тире
  `3` | Точка
  `4` | Тире точка
  `5` | Тире точка точка

`FontFamily`

- Установить для метки шрифт

`FontSize`

- Установить для метки размер шрифта.

`FontWeight`

- Устанавливает насыщенность шрифта для текста метки.

  Значение | Толщина шрифта
  `25` | Тонкий
  `50` | Обычный
  `63` | Тонкий полужирный
  `75` | Полужирный
  `87` | Жирный

`FontItalic`

- Устанавливает метку курсива шрифта для текста метки.

  Значение | Italic
  `0` | False
  `1` | True

`HAlignment`

- Установить для метки горизонтальное выравнивание текста.

  Значение | Выравнивание по горизонтали
  `0` | Влево
  `1` | По центру
  `2` | В право

`VAlignment`

- Установить для метки вертикальное выравнивание текста.

  Значение | Выравнивание по высоте
  `0` | Вверх
  `1` | По середине
  `2` | Вниз

`WordWrap`

- Установить для поля метку автоматического переноса слов.

  Значение | Переносы
  `0` | False
  `1` | True

## `Field`

Элемент `Поле` определяет объект отчёта используемый для вывода данных.

    <!ELEMENT Field EMPTY>
    <!ATTLIST Field
         Field           CDATA #REQUIRED
         Text            CDATA #REQUIRED
         X               CDATA #REQUIRED
         Y               CDATA #REQUIRED
         Width           CDATA #REQUIRED
         Height          CDATA #REQUIRED
         BackgroundColor CDATA #REQUIRED
         ForegroundColor CDATA #REQUIRED
         BorderColor     CDATA #REQUIRED
         BorderWidth     CDATA #REQUIRED
         BorderStyle     CDATA #REQUIRED
         FontFamily      CDATA #REQUIRED
         FontSize        CDATA #REQUIRED
         FontWeight      CDATA #REQUIRED
         FontItalic      CDATA #REQUIRED
         HAlignment      CDATA #REQUIRED
         VAlignment      CDATA #REQUIRED
         WordWrap        CDATA #REQUIRED
         DataType        CDATA #REQUIRED
         DateFormat      CDATA #REQUIRED
         Precision       CDATA #REQUIRED
         Currency        CDATA #REQUIRED
         NegValueColor   CDATA #REQUIRED
         CommaSeparator  CDATA #REQUIRED>

Атрибуты

- `Field`

- Установить поле данных для объекта. Это атрибут элемента `строка` в файле данных.

`Text`

- Не используется

`X`

- Устанавливает для поля координату начала x (относительно верхнего левого угла секции) для его позиционирования.

`Y`

- Устанавливает для метки координату начала y (относительно верхнего левого угла секции) для его позиционирования.

`Width`

- Установить для поля длину.

`Height`

- Установить для поля высоту.

`BackgroundColor`

- Установить цвет фона для поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`ForegroundColor`

- Установить цвет поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`BorderColor`

- Установить цвет границы для поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`BorderWidth`

- Установить для поля толщину границы.

`BorderStyle`

- Установить для поля стиль границы.

  Значение | Стиль границы
  `0` | Нет
  `1` | Непрерывная
  `2` | Тире
  `3` | Точка
  `4` | Тире точка
  `5` | Тире точка точка

`FontFamily`

- Установить для текстового поля шрифт

`FontSize`

- Установить для текстового поля размер шрифта

`FontWeight`

- Устанавливает насыщенность шрифта для текста поля.

  Значение | Толщина шрифта
  `25` | Тонкий
  `50` | Обычный
  `63` | Тонкий полужирный
  `75` | Полужирный
  `87` | Жирный

`FontItalic`

- Устанавливает метку курсива шрифта для текста поля.

  Значение | Italic
  `0` | False
  `1` | True

`HAlignment`

- Установить для поля горизонтальное выравнивание текста

  Значение | Выравнивание по горизонтали
  `0` | Влево
  `1` | По центру
  `2` | В право

`VAlignment`

- Установить для поля вертикальное выравнивание текста.

  Значение | Выравнивание по высоте
  `0` | Вверх
  `1` | По середине
  `2` | Вниз

`WordWrap`

- Установить метку переноса строк для текстового поля.

  Значение | Переносы
  `0` | False
  `1` | True

`DataType`

- Установить для поля тип данных.

  Значение | Тип данных
  `0` | Строка
  `1` | Целое число
  `2` | Число с дробью
  `3` | Дата
  `4` | Деньги

`DateFormat`

- Установить в поле формат даты. Для того чтобы работать, даты в файле данных должен быть в формате mm/dd/yyyy или mm-dd-yyyy, иначе используется исходный формат даты. Если тип данных не является датой, устанавливается в `0`.

  Значение | Формат даты
  `0` | м/д/гг
  `1` | м-д-гг
  `2` | мм/дд/гг
  `3` | мм-дд-гг
  `4` | м/д/гггг
  `5` | м-д-гггг
  `6` | мм/дд/гггг
  `7` | мм-дд-гггг
  `8` | гггг/м/д
  `9` | гггг-м-д
  `10` | дд.мм.гг
  `11` | дд.мм.гггг

`Precision`

- Установить точность в числовом поле. Если тип данные не является числовым, устанавливается в 0.

`Currency`

- Установить в поле символ денег если тип данных не является денежным, устанавливается в `36` ($). Это значение представляющее символ Unicode.

`NegValueColor`

- Установить цвет отрицательных значений. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255. Если данные не являются числами, установить в 255,0,0.

`CommaSeparator`

- Устанавливает используются ли в числовых полях запятые. Если тип данных не является числовым, устанавливается в `0`.

  Значение | Десятичный разделитель
  `0` | False
  `1` | True

## `CalculatedField`

Элемент `CalculatedField` определяет объект отчёта используемый для вывода рассчитываемых значений.

    <!ELEMENT CalculatedField EMPTY>
    <!ATTLIST CalculatedField
         CalculationType CDATA #REQUIRED
         Field           CDATA #REQUIRED
         Text            CDATA #REQUIRED
         X               CDATA #REQUIRED
         Y               CDATA #REQUIRED
         Width           CDATA #REQUIRED
         Height          CDATA #REQUIRED
         BackgroundColor CDATA #REQUIRED
         ForegroundColor CDATA #REQUIRED
         BorderColor     CDATA #REQUIRED
         BorderWidth     CDATA #REQUIRED
         BorderStyle     CDATA #REQUIRED
         FontFamily      CDATA #REQUIRED
         FontSize        CDATA #REQUIRED
         FontWeight      CDATA #REQUIRED
         FontItalic      CDATA #REQUIRED
         HAlignment      CDATA #REQUIRED
         VAlignment      CDATA #REQUIRED
         WordWrap        CDATA #REQUIRED
         DataType        CDATA #REQUIRED
         DateFormat      CDATA #REQUIRED
         Precision       CDATA #REQUIRED
         Currency        CDATA #REQUIRED
         NegValueColor   CDATA #REQUIRED
         CommaSeparator  CDATA #REQUIRED>

Атрибуты

- `CalculationType`

- Установить для поля тип расчёта.

  Значение | Расчёт
  `0` | Количество
  `1` | Сумма
  `2` | Среднее число
  `3` | Дисперсия
  `4` | Стандартное отклонение

`Field`

- Установить поле данных для объекта. Это атрибут элемента `строка` в файле данных.

`Text`

- Не используется

`X`

- Устанавливает для поля координату начала x (относительно верхнего левого угла секции) для его позиционирования.

`Y`

- Устанавливает для метки координату начала y (относительно верхнего левого угла секции) для его позиционирования.

`Width`

- Установить для поля длину.

`Height`

- Установить для поля высоту.

`BackgroundColor`

- Установить цвет фона для поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`ForegroundColor`

- Установить цвет поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`BorderColor`

- Установить цвет границы для поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`BorderWidth`

- Установить для поля толщину границы.

`BorderStyle`

- Установить для поля стиль границы.

  Значение | Стиль границы
  `0` | Нет
  `1` | Непрерывная
  `2` | Тире
  `3` | Точка
  `4` | Тире точка
  `5` | Тире точка точка

`FontFamily`

- Установить для текстового поля шрифт

`FontSize`

- Установить для текстового поля размер шрифта

`FontWeight`

- Устанавливает насыщенность шрифта для текста поля.

  Значение | Толщина шрифта
  `25` | Тонкий
  `50` | Обычный
  `63` | Тонкий полужирный
  `75` | Полужирный
  `87` | Жирный

`FontItalic`

- Устанавливает метку курсива шрифта для текста поля.

  Значение | Italic
  `0` | False
  `1` | True

`HAlignment`

- Установить для поля горизонтальное выравнивание текста

  Значение | Выравнивание по горизонтали
  `0` | Влево
  `1` | По центру
  `2` | В право

`VAlignment`

- Установить вертикальное выравнивание текста в поле.

  Значение | Выравнивание по высоте
  `0` | Вверх
  `1` | По середине
  `2` | Вниз

`WordWrap`

- Установить метку переноса строк для текстового поля.

  Значение | Переносы
  `0` | False
  `1` | True

`DataType`

- Установить для поля тип данных.

  Значение | Тип данных
  `0` | Строка
  `1` | Целое число
  `2` | Число с дробью
  `3` | Дата
  `4` | Деньги

`DateFormat`

- Установить в поле формат даты. Для того чтобы работать, даты в файле данных должен быть в формате mm/dd/yyyy или mm-dd-yyyy, иначе используется исходный формат даты. Если тип данных не является датой, устанавливается в `0`.

  Значение | Формат даты
  `0` | м/д/гг
  `1` | м-д-гг
  `2` | мм/дд/гг
  `3` | мм-дд-гг
  `4` | м/д/гггг
  `5` | м-д-гггг
  `6` | мм/дд/гггг
  `7` | мм-дд-гггг
  `8` | гггг/м/д
  `9` | гггг-м-д
  `10` | дд.мм.гг
  `11` | дд.мм.гггг

`Precision`

- Установить точность в числовом поле. Если тип данные не является числовым, устанавливается в 0.

`Currency`

- Установить в поле символ денег если тип данных не является денежным, устанавливается в `36` ($). Это значение представляющее символ Unicode.

`NegValueColor`

- Установить цвет отрицательных значений. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255. Если данные не являются числами, установить в 255,0,0.

`CommaSeparator`

- Устанавливает используются ли в числовых полях запятые. Если тип данных не является числовым, устанавливается в `0`.

  Значение | Десятичный разделитель
  `0` | False
  `1` | True

## `Special`

`Специальный` элемент определяет объект отчёта используемый для вывода номера страниц и даты отчёта.

    <!ELEMENT Special EMPTY>
    <!ATTLIST Special
         Type            CDATA #REQUIRED
         Text            CDATA #REQUIRED
         X               CDATA #REQUIRED
         Y               CDATA #REQUIRED
         Width           CDATA #REQUIRED
         Height          CDATA #REQUIRED
         BackgroundColor CDATA #REQUIRED
         ForegroundColor CDATA #REQUIRED
         BorderColor     CDATA #REQUIRED
         BorderWidth     CDATA #REQUIRED
         BorderStyle     CDATA #REQUIRED
         FontFamily      CDATA #REQUIRED
         FontSize        CDATA #REQUIRED
         FontWeight      CDATA #REQUIRED
         FontItalic      CDATA #REQUIRED
         HAlignment      CDATA #REQUIRED
         VAlignment      CDATA #REQUIRED
         WordWrap        CDATA #REQUIRED
         DateFormat      CDATA #REQUIRED>

Атрибуты

- `Type`

- Установить тип специального объекта.

  Значение | Type
  `0` | Текущая дата
  `1` | Номер страницы

`Text`

- Не используется

`X`

- Устанавливает для поля координату начала x (относительно верхнего левого угла секции) для его позиционирования.

`Y`

- Устанавливает для метки координату начала y (относительно верхнего левого угла секции) для его позиционирования.

`Width`

- Установить для поля длину.

`Height`

- Установить для поля высоту.

`BackgroundColor`

- Установить цвет фона для поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`ForegroundColor`

- Установить цвет поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`BorderColor`

- Установить цвет границы для поля. Цвет определён как значение RGB (Красный Зелёный Синий r,g,b). r, g и b должны находиться в диапазоне 0..255.

`BorderWidth`

- Установить для поля толщину границы.

`BorderStyle`

- Установить для поля стиль границы.

  Значение | Стиль границы
  `0` | Нет
  `1` | Непрерывная
  `2` | Тире
  `3` | Точка
  `4` | Тире точка
  `5` | Тире точка точка

`FontFamily`

- Установить для текстового поля шрифт

`FontSize`

- Установить для текстового поля размер шрифта

`FontWeight`

- Устанавливает насыщенность шрифта для текста поля.

  Значение | Толщина шрифта
  `25` | Тонкий
  `50` | Обычный
  `63` | Тонкий полужирный
  `75` | Полужирный
  `87` | Жирный

`FontItalic`

- Устанавливает метку курсива шрифта для текста поля.

  Значение | Italic
  `0` | False
  `1` | True

`HAlignment`

- Установить для поля горизонтальное выравнивание текста

  Значение | Выравнивание по горизонтали
  `0` | Влево
  `1` | По центру
  `2` | В право

`VAlignment`

- Установить вертикальное выравнивание текста в поле.

  Значение | Выравнивание по высоте
  `0` | Вверх
  `1` | По середине
  `2` | Вниз

`WordWrap`

- Установить метку переноса строк для текстового поля.

  Значение | Переносы
  `0` | False
  `1` | True

`DateFormat`

- Установить в поле формат даты. Для того чтобы работать, даты в файле данных должен быть в формате mm/dd/yyyy или mm-dd-yyyy, иначе используется исходный формат даты. Если тип данных не является датой, устанавливается в `0`.

  Значение | Формат даты
  `0` | м/д/гг
  `1` | м-д-гг
  `2` | мм/дд/гг
  `3` | мм-дд-гг
  `4` | м/д/гггг
  `5` | м-д-гггг
  `6` | мм/дд/гггг
  `7` | мм-дд-гггг
  `8` | гггг/м/д
  `9` | гггг-м-д
  `10` | дд.мм.гг
  `11` | дд.мм.гггг

`Precision`

- Установить точность в числовом поле. Если тип данные не является числовым, устанавливается в 0.