Appearance
Внешний вид. Задаются настройки размера поля, его положения в группе (Band), Тип позиции, Тип растяжения, Настройки печати и условия печати.
| Категория \ Свойство | Выпадающее меню | Описание |
|---|---|---|
Location | ||
x,y | Координаты расположения верхнего левого угла в группе в пикселях | |
Position Type(Поведение поля, в случае расширения Группы вертикально) | Float | Обозначает, что поле будет «плавающим», то есть оно будет сдвигаться относительно других элементов |
| Fix Relative To Top | Обозначает, что верхняя граница поля будет прикреплена к верхней границе группы | |
| Fix Relative To Bottom | Обозначает, что нижняя граница поля будет прикреплена к нижней границе группы | |
Size | ||
w, h | Определяет размер поля в пикселях (width, height). | |
Stretch Type | No Stretch | Не растягивать. Используется в случае, если текстовое поле должно оставаться оригинального размера. |
| Relative To Tallest Object | Растягивается относительно самого высокого объекта. Используется в большинстве случаев, подстраиваясь относительно своих соседей | |
| Relative To Band Height | Растягивается относительно высоты группы. Используется в случае, если размер объектов должен занимать определенный % высоты группы. | |
Color | ||
Forecolor | Диалог для выбора цвета | Задает цвет текста |
Backcolor | Диалог для выбора цвета | Задает цвет ячейки (не важен, если установлена галка Transparent) |
Transparent | Ячейка прозрачная, backcolor не используется | |
Style and Print Details(задает поведение текстового поля относительно стиля и настроек) | ||
Key | Нет опыта использования | |
Style | Список стилей | Стили можно создать в Outline |
Print Repeated Values | Не печатает, если значения этого поля повторяются (например если полю сказано печатать список значений и некоторые в них повторяются) | |
Remove Line When Blank | Схлопывает неиспользуемое собой пространство, если в поле ничего не печатается и в той же горизонтальной плоскости нет других печатающихся полей | |
Print in First Whole Band | В случае, если элемент будет разбит на 2 части новой страницей, он не разбивается и целиком печатается на новой странице. В некоторых случаях используется, если имеются проблемы с переносом полей. | |
Print When(определяются условия печати элемента) | ||
Detail Overflows | Элемент будет печататься, если он разбивается новой страницей | |
Group Changes | Если группа изменилась, тогда печатать. | |
Print when Expression | java операнд, возвращающий Boolean. Если True – печатаем, False – не печатаем. | |
Для справки
- А4 в мм = 210мм * 297мм
- А4 в px = 595px *842px
- 1мм ~ 2,834px
Borders
| Свойство | Описание |
|---|---|
Padding | Отступы. Определяет расстояние текста в пикселях от границ текстового поля. |
Borders | Границы. Определяет цвет, тип и толщину границы текстового поля. Можно выбрать границы в левой части и модифицировать их отдельно справа. |
Text Field
| Категория \ Свойство | Выпадающее меню | Описание |
|---|---|---|
Expression | Выражение для текстового поля. | |
Evaluation Time | Now | Определяет в какое время будет вычислено значение выражения. Например, если в заголовке есть счетчик количества строк отчета, например «Количество документов», то будет значение 0. |
| Report | Значение вычисляется после вывода всех строк данного отчета, то есть будет выведено количество документов по окончанию построения отчета. | |
| Page | Значение вычисляется – по окончанию данной страницы | |
Blank When NULL | Должно выводиться пустое текстовое поле, если в нем содержится null. Но по каким-то причинам не работает как ожидается. Приходится использовать обработку внутри Expression, например таким образом: ($F{resolution} == null ? "" : $F{resolution}) | |
Stretch With Overflow | Очень важное значение. Определяет, будет ли поле расширяться вертикально, если текст не умещается в заданных по умолчанию размерах. | |
Pattern | Шаблон для форматирования содержимого поля | Определяется форматирование возвращаемого значения. На практике обычно используется форматирование всех значений в поле Expression. |
Pattern Expression | Как и Pattern, только позволяет задать строку expression с помощью Java выражения, применив тернарные операторы и т.д. На практике редко используется. | |
Text Alignment | Горизонтальная и вертикальная ориентация текста. | |
Rotation | Поворот текста. Удобно для создания узких колонок с сохранением описания. Обычно выбирается снизу вверх, если это необходимо. | |
FontЗадается тип шрифта, размер, полужирный, курсив, подчеркнутый, перечеркнутый и т.д. | ||
Markup | none | Язык разметки не выбирается. Используется наиболее часто. |
| styled | Styled требует создания пользовательского util.MarkupProcessorFactory (более подробно в официальной документации) | |
| html | Используются html теги форматирования. | |
| rtf | Используются rtf теги форматирования. | |
Paragraph | ||
Line Spacing | Выбирается количество интервалов между строками текста в параграфе. По умолчанию 1 | |
Line Spacing Size | Размер интервала между строками текста внутри параграфа | |
First Line Indent | Табуляция отступа первой строки параграфа | |
Left Indent | Отступ слева | |
Right Indent | Отступ справа | |
Spacing Before | Расстояние до первой строки параграфа сверху | |
Spacing After | Расстояние после последней строки параграфа снизу | |
Tab Stop Width | Максимальная ширина табуляции | |
Inheritance
Показано, какие атрибуты наследуются из стиля и значений по умолчанию.
Hyperlink
Можно определить закладки и переходы по документу, а также ссылки в вэб.
Структура меню меняется в зависимости от выбранного Типа Ссылки (LinkType). Ссылка (Reference) открывает новое поле HyperlinkReferenceExpression, которое может содержать java операнд. Можно также вписать жесткую ссылку.
| Свойство | Описание |
|---|---|
HyperlinkWhenExpression | Операнд, ожидается Boolean. Если true – тогда сделать текстовое поле ссылкой. Если false – текстовое поле не превращается в ссылку. |
HyperlinkTooltipExpression | Операнд возвращающий текст. Этот текст выводится при наведении на ссылку. |
Advanced
Существует особенность формирования отчетов в формате PDF и содержащих кириллические символы. Для корректного отображения текста на русском языке необходимо в свойствах полей отчета указать следующие параметры
- PDF Embedded true
- PDF Encoding -CP1251 (Cirillic)
- PDF Font Name DejaVuSans.ttf
Статический текстовый элемент используется, чтобы показать не динамический текст в отчетах. Единственный параметр, который отличает этот элемент от универсального текстового элемента - это свойство LabelStatic Text вместо Text Field, в котором указывается текст для просмотра: это обычный текст, а не выражение.
Параметры: