Паттерн
«Паттерн» – это компонент формуляра, связанный с определенным фрагментом (прямоугольной областью) в Excel-шаблоне, которую необходимо будет тиражировать (т.е. повторить определенное количество раз) при формировании результирующего XLSX-файла.
Другими словами «Паттерны» – это такие «кусочки», которые, в определенной Вами последовательности, будут выкладываться на Лист результирующего XLSX-файла, образуя его наполнение.
Примечание: Последовательность вставки паттернов в результирующий XLSX-файл определяется только последовательностью компонентов в дереве структуры формуляра (а никак не текущим расположением их относительно друг друга в Excel-шаблоне).
Вкладка свойств:
Пункт «Область в шаблоне»
Данный пункт необходим для сопоставления паттерна с областью ячеек в Excel-шаблоне. Для сопоставления необходимо проделать следующее (в указанном порядке):
в Excel-шаблоне выделите требуемую область ячеек;
нажмите на кнопку в пункте «Область в шаблоне».
Пункт «Появление при выводе»
По умолчанию, Паттерн будет всегда выводиться в Печатную форму (результирующий XLSX-файл) . Однако, есть возможность динамически задавать появление компонента в Печатной форме.
Данный пункт позволяет связать вывод компонента с наличием значения в каком-либо поле контекста (т.е. Паттерн появится в Печатной форме только в случае, если указанное поле контекста не пустое).
Необходимо нажать на кнопку «Карандаш»
и в средстве поиска выбрать требуемое поле контекста (т.н. индикатор появления):
Если в качестве индикатора появления выбрано текстовое поле, то имеется возможность анализировать как содержимое поля целиком, так и его фрагмент. Чтобы определить фрагмент поля, требуется нажать на кнопку
и, на всплывающем экране, указать с какой позиции и сколько символов следует анализировать.
Пункт «Направление вывода»
Данный пункт определяет расположение текущего паттерна относительно предыдущего компонента. Чтобы сменить направление вывода, необходимо нажать на кнопку:
По умолчанию, задано направление
это означает, что текущий паттерн при выводе будет располагаться НИЖЕ предыдущего компонента. При этом верхний левый угол текущего паттерна (обозначен зеленым цветом) будет примыкать к нижнему левому углу предыдущего компонента (обозначен желтым цветом):
Если задано направление:
это означает, что текущий паттерн при выводе будет располагаться ПРАВЕЕ предыдущего компонента. При этом верхний левый угол текущего паттерна (обозначен зеленым цветом) будет примыкать к верхнему правому углу предыдущего компонента (обозначен желтым цветом):
Если предыдущие компоненты заключены в папку, то вышеописанные принципы применяются к границам папки.
Пример 1: Текущий паттерн (зеленым цветом) располагается ниже предыдущей папки (синим цветом).
Пример 2: Текущий паттерн (зеленым цветом) располагается правее предыдущей папки (синим цветом).
Пункт «Копировать свойства»
Опция копирования свойств, относящихся к строкам/столбцам (ширина, высота, видимость и др.)
Пункт «Автоподбор размеров объединенных ячеек»
Предпосылки: Если ячейка не объединенная, то автоподбор ширины или высоты настраивается в её свойствах в Excel-шаблоне и прекрасно работает. Однако, для объединенных ячеек эта опция, к сожалению, бесполезна.
Данная опция запускает процедуру OLE/VBScript пост-обработки, которая принудительно подберет размер ячейки по содержимому.
Примечание: Рекомендуется применять пост-обработку только при крайней необходимости, т.к. она имеет ряд негативных моментов:
Она не будет выполнена при запуске программы печати в фоновом режиме
Она не будет выполнена при отсутствии приложения MS Excel на локальной машине пользователя
Увеличивается время получения готовой формы
Пункт «Копировать формулы из шаблона»
По умолчанию этот чекбокс снят, по этому формулы не будут перенесены из шаблона в результирующий файл. Необходимо передавать формулы из программы печати в форму посредством компонента ЗНАЧЕНИЕ.
Если это чекбокс включен, все формулы в пределах текущего ПАТТЕРНА будут переданы "как есть" из шаблона в результирующий файл. Здесь "как есть" означает - без коррекции адресов ячеек, по этому возможны коллизии/ ошибки/ зацикливание формул. Используйте эту опцию осторожно.