Рисунок
Компонент «Рисунок» позволяет разместить на листе формуляра изображение (как пиксельное, так и векторное).
В дереве структуры формуляра, «Рисунок» (как и «Значение») всегда располагается непосредственно под «Паттерном» (как дочерний узел).
Вкладка свойств:
Пункт «Область в шаблоне»
Данный пункт необходим для сопоставления рисунка с целевой прямоугольной областью в Excel-шаблоне. Область рисунка не должна выходить за пределы вышестоящего «Паттерна». При формировании XLSX-файла, рисунок будет вписан в эту область, при этом будет применено необходимое его масштабирование.
Для сопоставления необходимо проделать следующее (в указанном порядке):
в Excel-шаблоне выделите ячейки, внутри которых должен будет разместиться рисунок;
нажмите на кнопку
в пункте «Область в шаблоне»
после чего рисунок будет сопоставлен с выделенной областью.
Пункт «Размер»
Данный пункт необходим для установки размера Рисунка. Есть два режима:
Вписать рисунок в область, заданную в предыдущем пункте «Область в шаблоне» ;
Получить значения Ширины и Высоты рисунка из поля контекста.
При этом, Левый-Верхний угол рисунка совпадает с Левым-Верхним углом области, заданной в предыдущем пункте «Область в шаблоне. Значения Ширины и Высоты рисунка берутся из заданного поля контекста. Значения Ширины и Высоты должны быть заданы в English Metric Units (or EMUs) (для примера, начальная высота одной строки Excel, приблизительно равна 200000 EMU) .
Пункт «Появление при выводе»
По умолчанию, Рисунок будет всегда выводиться в Печатную форму (результирующий XLSX-файл) .
В данном пункте можно сделать так, чтобы вывод Рисунка (в результирующий XLSX-файл) был зависим от наличия значения в каком-либо поле контекста (т.е. появление Рисунка, если это поле не пустое). Для этого необходимо нажать на кнопку
и в средстве поиска выбрать требуемое поле контекста (т.н. индикатор появления):
Если в качестве индикатора появления выбрано текстовое поле, то имеется возможность анализировать как содержимое поля целиком, так и его фрагмент.
Для этого требуется нажать на кнопку
и, на всплывающем экране, указать с какой позиции и сколько символов следует анализировать:
Пункт «Источник»
Источник изображения может быть статическим или динамическим.
Статический источник изображения
Это любое пиксельное изображение (меню Excel: Вставка > Иллюстрации > Рисунок), или векторный рисунок (меню Excel: Вставка > Иллюстрации > Фигуры), находящийся на актуальном листе Excel-шаблона.
Для того, чтобы сопоставить компонент «Рисунок» с источником, необходимо нажать на кнопку «Карандаш» и, в средстве поиска выбрать требуемый рисунок (из тех, что расположены на актуальном листе шаблона):
Динамический источник изображения
Это любое поле контекста, имеющее формат XSTRING (RAWSTRING), которое будет содержать пиксельное изображение (.jpg / .png / .gif) в виде последовательности байтов.
Для того, чтобы сопоставить компонент «Рисунок» с источником, необходимо нажать на кнопку «Карандаш» и, в средстве поиска выбрать требуемое поле из контекста: