Для большей визуальной выразительности и восприятия информации, в отчеты нередко добавляют изображения. Это могут быть изображения товаров, фотографии сотрудников, логотип компании и т.д. Для вывода изображений в Stimulsoft Reports используется компонент Изображение (Image). Этот компонент поддерживает следующие типы изображений: BMP, PNG, JPEG, TIFF, GIF, PNG, ICO, EMF, SVG, WMF. Компонент Изображение необходимо размещать в том месте, где необходимо расположить изображение (страница отчета, бэнд Данные, заголовок, итог и т.д.).

 

 

 

Для того чтобы добавить изображение в отчет, следует:
strel11 Выбрать компонент Изображение на Инструментарии (Toolbox) или вкладке Вставить (Insert) в группе Компоненты (Components);

strel11 Разместить этот компонент на странице отчета или на бэнде отчета.

 

Настройка компонента Изображение осуществляется при помощи:

strel11 Редактора компонента, в котором осуществляется выбор источника для изображений;

strel11 Списка свойств этого компонента.

 

Для того чтобы вызвать редактор, следует:
strel11 Осуществить двойной щелчок по компоненту Изображение;
strel11 Выделить компонент Изображение, и в контекстном меню выбрать команду Редактировать (Design);

 

 

Редактор изображений

После вызова редактора компонента Изображение, необходимо определить источник для изображения этого компонента. Ниже представлен редактор компонента Изображение:

 

 

img_1 Перечень источников для компонента. Каждый из вариантов источника для изображения представлен на отдельной вкладке в редакторе:

strel11 Источник Изображение (Image) предоставляет возможность перетащить или открыть изображение из локального хранилища.

strel11 Источник Колонка данных (Data Column) предоставляет возможность выбрать колонку данных, из которой будут получены изображения для этого компонента.

strel11 Источник Выражение (Expression) предоставляет возможность указать выражение, результатом вычисления которого будет изображение для этого компонента. Например, изображение может быть получено из переменной - {Variable1}. Также, стоит обратить внимание, что при помощи выражения можно получить изображение из файла. Для этого следует воспользоваться методом FromFile компонента Image, например, {Image.FromFile("c:\Image.png")}.

strel11 Источник URL изображения (Image URL) предоставляет возможность получить изображение по URL. Также, можно указать ссылку на ресурсы отчета, например, resource://image. В этом случае, будет загружено изображение из ресурсов отчета с именем image.

strel11 Источник Файл (File) предоставляет возможность загрузить изображение из файла. Для этого следует указать путь к файлу, например, d:\image.png.

strel11 Источник Значок (Icon) предоставляет возможность выбрать значок из набора и определить его цвет.

img_2 Область эскиза, где отображается пример изображения. Отсутствует для источников Колонка данных и Выражение.
img_3 Элементы управления:

strel11 Для источника Изображение будут доступны следующие элементы управления: Открыть (Open), Сохранить (Save), Переместить в ресурсы (Move to Resource), Удалить (Remove).

strel11 Для источника Значок будут доступны следующие элементы управления: меню выбора значка и его цвета.

strel11 Для источника Выражение и URL изображения будет доступны команда вызова текстового редактора.

strel11 Для источника Файл доступна команда Обзор (Browse), которая будет вызывать проводник локального хранилища.

strel11 Для источника Колонка данных будет доступна дерево источников и колонок данных.

 

Информация

 

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

 

 

 

Дополнительные панели

В редакторе компонента Изображение могут отображаться дополнительные панели:
strel11 Панель Галерея (Gallery) на которой отображаются перечень изображения в виде миниатюр из переменных и ресурсов. Эта панель будет отображаться только для источника Изображение.
strel11 Панель История (History) на которой отображаются перечень последних успешно загруженных изображения. Эта панель будет отображаться только для источников Файл и URL изображения.

 

 

Растягивание изображения

При выводе изображений очень часто размеры изображения не совпадают с размерами компонента. В этом случае остается пустое, незаполненное изображением пространство. Также возникают ситуации, когда размеры изображение больше, чем размеры компонента. В этом случае, можно включить режим растягивания изображения до размеров компонента. Для этого следует свойство Растягивать (Stretch) установить в значение Да (True).

 

 

 

После включения режима растягивания изображения, его размеры будут всегда соответствовать размерам компонента. Однако, в этом случае, могут нарушиться пропорции изображения. Для того чтобы растягивать изображения, но при этом сохранять пропорции изображения, необходимо установить свойство Отношение сторон (Aspect Ratio) в значение Да (True). После этого компонент Картинка (Image) всегда будет сохранять пропорции изображения.

 

 

Информация

 

Свойство Отношение сторон (Aspect Ratio) работает только когда включен режим растягивания изображения.

 

 

 

Таблица свойств
В таблице ниже представлен перечень свойств текущего компонента.

 

Наименование

Описание

Изображение
(Image)

Предоставляет возможность открыть редактор компонента на вкладке источника Изображение.

Колонка данных
(Data Column)

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

Файл
(File)

Предоставляет возможность открыть редактор компонента на вкладке источника Файл.

Значок
(Icon)

Предоставляет возможность выбрать значок для источника компонента.

Выражение изображения
(Expression)

Предоставляет возможность открыть редактор компонента на вкладке источника Выражение.

URL изображения
(Image URL)

Предоставляет возможность открыть редактор компонента на вкладке источника URL изображения.

Соотношение сторон
(Aspect Ratio)

Предоставляет возможность включить или выключить режим соотношения сторон изображения для изображения. Актуально, только если режим растягивания включен. Если свойство установлено в значение Да (True), то соотношение сторон изображения в текущем компоненте будет сохранено. Если же данное свойство установлено в значение Нет (False), то соотношение сторон учитываться не будет и изображение будет растягиваться не пропорционально.

Горизонтальное выравнивание
(Horizontal Alignment)

Предоставляет возможность изменить горизонтальное выравнивание изображения в текущем компоненте.

Вертикальное выравнивание
(Vertical Alignment)

Предоставляет возможность изменить вертикальное выравнивание изображения в текущем компоненте.

Поворот изображения
(Image Rotation)

Предоставляет возможность повернуть изображение в текущем компоненте.

Поля
(Margins)

Группа свойств, которая предоставляет возможность определить границы изображения по отношению к границам компонента - Слева (Left), Справа (Right), Сверху (Top), Снизу (Bottom).

Кратный множитель
(Multiple Factor)

Предоставляет возможность установить значение для умножения на размер изображения.

Обработка дубликатов
(Processing Duplicates)

Предоставляет возможность определить режим обработки дубликатов текущего изображения.

Сглаживание
(Smoothing)

Предоставляет возможность включить или выключить режим сглаживания для изображений.

Растягивать
(Stretch)

Предоставляет возможность включить или выключить режим растягивания изображения в компоненте. При использовании режима растягивания можно сохранить пропорции изображения или нет используя свойство Соотношение сторон. Если свойство установлено в значение Да (True), то изображение будет растягиваться в компоненте. Если же данное свойство установлено в значение Нет (False), то изображение растягиваться не будет..

Слева

(Left)

Отступ текущего компонента от левой границы страницы. Значение указывается в единицах измерения отчета.

Сверху
(Top)

Отступ текущего компонента от верхней границы страницы. Значение указывается в единицах измерения отчета.

Ширина

(Width)

Ширина текущего компонента. Значение указывается в единицах измерения отчета.

Высота

(Height)

Высота текущего компонента. Значение указывается в единицах измерения отчета.

Минимальный размер

(Min Size)

Группа свойств, которая предоставляет возможность указать минимальную ширину и высоту для текущего компонента.

Максимальный размер
(Max Size)

Группа свойств, которая предоставляет возможность указать максимальную ширину и высоту для текущего компонента.

Граница
(Border)

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

Кисть
(Brush)

Предоставляет возможность изменить тип кисти и её настройки для текущего компонента.

Условия
(Conditions)

Предоставляет возможность вызвать редактор условий для текущего компонента. Для этого необходимо нажать кнопку Обзор (Browse) в поле значения текущего свойства.

Стиль компонента

(Component Style)

Предоставляет возможность выбрать стиль для текущего компонента. Также, в перечне значений данного свойства, присутствует команда Редактировать стили (Edit Styles), которая предоставляет возможность вызвать Дизайнер стилей (Style Designer).

Цвет значка
(Icon Color)

Предоставляет возможность выбрать цвет для значка. Актуально, в случае, если значок определен как источник для компонента Изображение.

Использовать стили владельца
(Use Parent Style)

Предоставляет возможность использовать для текущего компонента стиль, который применяется для компонента-владельца. Если текущее свойство установлено в значение Да (True), то для компонента будет применяться стиль компонента-владельца. Если же текущее свойство установлено в значение Нет (False), то для компонента будет применяться назначенный стиль.

Привязка
(Anchor)

Предоставляет возможность выбрать режим привязки текущего компонента к компоненту-владельцу.

Может разрываться
(Can Break)

Предоставляет возможность определить может компонент или не может разрывать содержимое на несколько страниц.

Может расти
(Can Grow)

Предоставляет возможность определить может или не может компонент расти в высоту.

Может сжиматься
(Can Shrink)

Предоставляет возможность определить может или не может компонент сжиматься по высоте.

Стиль стыковки
(Dock Style)

Предоставляет возможность выбрать режим стыковки текущего компонента с компонентом-владельцем.

Доступность
(Enabled)

Предоставляет возможность обрабатывать или не обрабатывать текущий компонент при построении отчета. Если текущее свойство установлено в значение Да (True), то компонент будет обрабатываться при построении отчета. Если же текущее свойство установлено в значение Нет (False), то компонент не будет обрабатываться при построении отчета.

Расти в высоту

(Grow to Height)

Предоставляет возможность увеличивать или уменьшать высоту компонента при построении отчета.  Если текущее свойство установлено в значение Да (True), то компонент будет растягиваться по высоте компонента-владельца. Если же текущее свойство установлено в значение Нет (False), то компонент не будет растягиваться по высоте компонента-владельца.

Взаимодействие
(Interaction)

Предоставляет возможность вызвать редактор взаимодействий для текущего компонента. Для этого необходимо нажать кнопку Обзор (Browse) в поле значения текущего свойства.

Печатать
(Printable)

Предоставляет возможность отображать или не отображать текущий компонент в построенном отчете. Если текущее свойство установлено в значение Да (True), то компонент будет отображаться в построенном отчете. Если же текущее свойство установлено в значение Нет (False), то компонент не будет отображаться в построенном отчете.

Печатать на
(Print On)

Предоставляет возможность определить режим отображения текущего компонента в построенном отчете.

Режим смещения
(Shift Mode)

Предоставляет возможность режим смещения компонента, который располагается под другим компонентом на одном уровне в иерархии компонентов отчета.

Наименование
(Name)

Предоставляет возможность изменить наименование текущего компонента в отчете.

Псевдоним
(Alias)

Предоставляет возможность указать псевдоним текущего компонента в отчете.

Ограничения
(Restrictions)

Предоставляет возможность настроить права использования текущего компонента:

strel11 Параметр Изменение допускается (Allow Change) предоставляет возможность разрешить или запретить изменение компонента. Если флажок установлен, то текущий компонент можно изменить. Если же флажок не установлен, то этот компонент изменить невозможно.
strel11 Параметр Удаление допускается (Allow Delete) предоставляет возможность разрешить или запретить удаление компонента. Если флажок установлен, то текущий компонент можно удалить. Если же флажок не установлен, то этот компонент удалить невозможно.
strel11 Параметр Перемещение допускается (Allow Move) предоставляет возможность разрешить или запретить перемещение компонента. Если флажок установлен, то текущий компонент можно переместить. Если же флажок не установлен, то этот компонент переместить невозможно.
strel11 Параметр Изменение размера допускается (Allow Resize) предоставляет возможность разрешить или запретить изменить размеры компонента. Если флажок установлен, то размеры текущего компонента можно изменить. Если же флажок не установлен, то размеры этого компонента изменить невозможно.
strel11 Параметр Выбор допускается (Allow Select) предоставляет возможность разрешить или запретить выбор компонента. Если флажок установлен, то текущий компонент можно выбрать. Если же флажок не установлен, то этот компонент выбрать невозможно.

Замок
(Locked)

Предоставляет возможность запретить или разрешить изменение размеров и перемещение текущего компонента. Если свойство установлено в значение Да (True), то текущий компонент невозможно будет переместить или изменить его размер. Если же данное свойство установлено в значение Нет (False), то этот компонент можно переместить и изменить его размеры.

Связь
(Linked)

Предоставляет возможность привязать текущее местоположение к странице отчета или другому компоненту. Если свойство установлено в значение Да (True), то текущий компонент привязан к текущему местоположению. Если же данное свойство установлено в значение Нет (False), то этот компонент не привязан к текущему местоположению.