Изображения
Для большей визуальной выразительности и восприятия информации, в отчеты нередко добавляют изображения. Это могут быть изображения товаров, фотографии сотрудников, логотип компании и т.д. Для вывода изображений в Stimulsoft Reports используется компонент Изображение (Image). Этот компонент поддерживает следующие типы изображений: BMP, PNG, JPEG, TIFF, GIF, PNG, ICO, EMF, SVG, WMF. Компонент Изображение необходимо размещать в том месте, где необходимо расположить изображение (страница отчета, бэнд Данные, заголовок, итог и т.д.).
Для того чтобы добавить изображение в отчет, следует:
Выбрать компонент Изображение на Инструментарии (Toolbox) или вкладке Вставить (Insert) в группе Компоненты (Components);
Разместить этот компонент на странице отчета или на бэнде отчета.
Настройка компонента Изображение осуществляется при помощи:
Редактора компонента, в котором осуществляется выбор источника для изображений;
Списка свойств этого компонента.
Для того чтобы вызвать редактор, следует:
Осуществить двойной щелчок по компоненту Изображение;
Выделить компонент Изображение, и в контекстном меню выбрать команду Редактировать (Design);
После вызова редактора компонента Изображение, необходимо определить источник для изображения этого компонента. Ниже представлен редактор компонента Изображение:
Перечень источников для компонента. Каждый из вариантов источника для изображения представлен на отдельной вкладке в редакторе:
Источник Изображение (Image) предоставляет возможность перетащить или открыть изображение из локального хранилища.
Источник Колонка данных (Data Column) предоставляет возможность выбрать колонку данных, из которой будут получены изображения для этого компонента.
Источник Выражение (Expression) предоставляет возможность указать выражение, результатом вычисления которого будет изображение для этого компонента. Например, изображение может быть получено из переменной - {Variable1}. Также, стоит обратить внимание, что при помощи выражения можно получить изображение из файла. Для этого следует воспользоваться методом FromFile компонента Image, например, {Image.FromFile("c:\Image.png")}.
Источник URL изображения (Image URL) предоставляет возможность получить изображение по URL. Также, можно указать ссылку на ресурсы отчета, например, resource://image. В этом случае, будет загружено изображение из ресурсов отчета с именем image.
Источник Файл (File) предоставляет возможность загрузить изображение из файла. Для этого следует указать путь к файлу, например, d:\image.png.
Источник Значок (Icon) предоставляет возможность выбрать значок из набора и определить его цвет.
Область эскиза, где отображается пример изображения. Отсутствует для источников Колонка данных и Выражение.
Элементы управления:
Для источника Изображение будут доступны следующие элементы управления: Открыть (Open), Сохранить (Save), Переместить в ресурсы (Move to Resource), Удалить (Remove).
Для источника Значок будут доступны следующие элементы управления: меню выбора значка и его цвета.
Для источника Выражение и URL изображения будет доступны команда вызова текстового редактора.
Для источника Файл доступна команда Обзор (Browse), которая будет вызывать проводник локального хранилища.
Для источника Колонка данных будет доступна дерево источников и колонок данных.
Информация |
Обратите внимание, можно указать настройки для разных источников изображения. Однако при построении отчета, будет использоваться тот источник, который обладает приоритетом. Приоритет источников определяется сверху вниз, т.е. источник Изображение имеет самый высокий приоритет, а источник Значок - самый низкий.
|
В редакторе компонента Изображение могут отображаться дополнительные панели:
Панель Галерея (Gallery) на которой отображаются перечень изображения в виде миниатюр из переменных и ресурсов. Эта панель будет отображаться только для источника Изображение.
Панель История (History) на которой отображаются перечень последних успешно загруженных изображения. Эта панель будет отображаться только для источников Файл и URL изображения.
При выводе изображений очень часто размеры изображения не совпадают с размерами компонента. В этом случае остается пустое, незаполненное изображением пространство. Также возникают ситуации, когда размеры изображение больше, чем размеры компонента. В этом случае, можно включить режим растягивания изображения до размеров компонента. Для этого следует свойство Растягивать (Stretch) установить в значение Да (True).
После включения режима растягивания изображения, его размеры будут всегда соответствовать размерам компонента. Однако, в этом случае, могут нарушиться пропорции изображения. Для того чтобы растягивать изображения, но при этом сохранять пропорции изображения, необходимо установить свойство Отношение сторон (Aspect Ratio) в значение Да (True). После этого компонент Картинка (Image) всегда будет сохранять пропорции изображения.
Информация |
Свойство Отношение сторон (Aspect Ratio) работает только когда включен режим растягивания изображения.
|
Таблица свойств
В таблице ниже представлен перечень свойств текущего компонента.
Наименование |
Описание |
Изображение |
Предоставляет возможность открыть редактор компонента на вкладке источника Изображение. |
Колонка данных |
Предоставляет возможность выбрать колонку данных для источника компонента. |
Файл |
Предоставляет возможность открыть редактор компонента на вкладке источника Файл. |
Значок |
Предоставляет возможность выбрать значок для источника компонента. |
Выражение изображения |
Предоставляет возможность открыть редактор компонента на вкладке источника Выражение. |
URL изображения |
Предоставляет возможность открыть редактор компонента на вкладке источника URL изображения. |
Соотношение сторон |
Предоставляет возможность включить или выключить режим соотношения сторон изображения для изображения. Актуально, только если режим растягивания включен. Если свойство установлено в значение Да (True), то соотношение сторон изображения в текущем компоненте будет сохранено. Если же данное свойство установлено в значение Нет (False), то соотношение сторон учитываться не будет и изображение будет растягиваться не пропорционально. |
Горизонтальное выравнивание |
Предоставляет возможность изменить горизонтальное выравнивание изображения в текущем компоненте. |
Вертикальное выравнивание |
Предоставляет возможность изменить вертикальное выравнивание изображения в текущем компоненте. |
Поворот изображения |
Предоставляет возможность повернуть изображение в текущем компоненте. |
Поля |
Группа свойств, которая предоставляет возможность определить границы изображения по отношению к границам компонента - Слева (Left), Справа (Right), Сверху (Top), Снизу (Bottom). |
Кратный множитель |
Предоставляет возможность установить значение для умножения на размер изображения. |
Обработка дубликатов |
Предоставляет возможность определить режим обработки дубликатов текущего изображения. |
Сглаживание |
Предоставляет возможность включить или выключить режим сглаживания для изображений. |
Растягивать |
Предоставляет возможность включить или выключить режим растягивания изображения в компоненте. При использовании режима растягивания можно сохранить пропорции изображения или нет используя свойство Соотношение сторон. Если свойство установлено в значение Да (True), то изображение будет растягиваться в компоненте. Если же данное свойство установлено в значение Нет (False), то изображение растягиваться не будет.. |
Слева (Left) |
Отступ текущего компонента от левой границы страницы. Значение указывается в единицах измерения отчета. |
Сверху |
Отступ текущего компонента от верхней границы страницы. Значение указывается в единицах измерения отчета. |
Ширина (Width) |
Ширина текущего компонента. Значение указывается в единицах измерения отчета. |
Высота (Height) |
Высота текущего компонента. Значение указывается в единицах измерения отчета. |
Минимальный размер (Min Size) |
Группа свойств, которая предоставляет возможность указать минимальную ширину и высоту для текущего компонента. |
Максимальный размер |
Группа свойств, которая предоставляет возможность указать максимальную ширину и высоту для текущего компонента. |
Граница |
Группа свойств, которая предоставляет возможность настроить отображение границ компонента. Определить можно стороны, которые будут отображаться, цвет границ, толщину и стиль, а также тень компонента. |
Кисть |
Предоставляет возможность изменить тип кисти и её настройки для текущего компонента. |
Условия |
Предоставляет возможность вызвать редактор условий для текущего компонента. Для этого необходимо нажать кнопку Обзор (Browse) в поле значения текущего свойства. |
Стиль компонента (Component Style) |
Предоставляет возможность выбрать стиль для текущего компонента. Также, в перечне значений данного свойства, присутствует команда Редактировать стили (Edit Styles), которая предоставляет возможность вызвать Дизайнер стилей (Style Designer). |
Цвет значка |
Предоставляет возможность выбрать цвет для значка. Актуально, в случае, если значок определен как источник для компонента Изображение. |
Использовать стили владельца |
Предоставляет возможность использовать для текущего компонента стиль, который применяется для компонента-владельца. Если текущее свойство установлено в значение Да (True), то для компонента будет применяться стиль компонента-владельца. Если же текущее свойство установлено в значение Нет (False), то для компонента будет применяться назначенный стиль. |
Привязка |
Предоставляет возможность выбрать режим привязки текущего компонента к компоненту-владельцу. |
Может разрываться |
Предоставляет возможность определить может компонент или не может разрывать содержимое на несколько страниц. |
Может расти |
Предоставляет возможность определить может или не может компонент расти в высоту. |
Может сжиматься |
Предоставляет возможность определить может или не может компонент сжиматься по высоте. |
Стиль стыковки |
Предоставляет возможность выбрать режим стыковки текущего компонента с компонентом-владельцем. |
Доступность |
Предоставляет возможность обрабатывать или не обрабатывать текущий компонент при построении отчета. Если текущее свойство установлено в значение Да (True), то компонент будет обрабатываться при построении отчета. Если же текущее свойство установлено в значение Нет (False), то компонент не будет обрабатываться при построении отчета. |
Расти в высоту (Grow to Height) |
Предоставляет возможность увеличивать или уменьшать высоту компонента при построении отчета. Если текущее свойство установлено в значение Да (True), то компонент будет растягиваться по высоте компонента-владельца. Если же текущее свойство установлено в значение Нет (False), то компонент не будет растягиваться по высоте компонента-владельца. |
Взаимодействие |
Предоставляет возможность вызвать редактор взаимодействий для текущего компонента. Для этого необходимо нажать кнопку Обзор (Browse) в поле значения текущего свойства. |
Печатать |
Предоставляет возможность отображать или не отображать текущий компонент в построенном отчете. Если текущее свойство установлено в значение Да (True), то компонент будет отображаться в построенном отчете. Если же текущее свойство установлено в значение Нет (False), то компонент не будет отображаться в построенном отчете. |
Печатать на |
Предоставляет возможность определить режим отображения текущего компонента в построенном отчете. |
Режим смещения |
Предоставляет возможность режим смещения компонента, который располагается под другим компонентом на одном уровне в иерархии компонентов отчета. |
Наименование |
Предоставляет возможность изменить наименование текущего компонента в отчете. |
Псевдоним |
Предоставляет возможность указать псевдоним текущего компонента в отчете. |
Ограничения |
Предоставляет возможность настроить права использования текущего компонента: Параметр Изменение допускается (Allow Change) предоставляет возможность разрешить или запретить изменение компонента. Если флажок установлен, то текущий компонент можно изменить. Если же флажок не установлен, то этот компонент изменить невозможно. |
Замок |
Предоставляет возможность запретить или разрешить изменение размеров и перемещение текущего компонента. Если свойство установлено в значение Да (True), то текущий компонент невозможно будет переместить или изменить его размер. Если же данное свойство установлено в значение Нет (False), то этот компонент можно переместить и изменить его размеры. |
Связь |
Предоставляет возможность привязать текущее местоположение к странице отчета или другому компоненту. Если свойство установлено в значение Да (True), то текущий компонент привязан к текущему местоположению. Если же данное свойство установлено в значение Нет (False), то этот компонент не привязан к текущему местоположению. |