Перейти к содержанию

Изображение: различия между версиями

Материал из Химсофт Вики
Нет описания правки
Нет описания правки
Строка 1: Строка 1:
<div style="background-color: #fff0f3; border-left: 5px solid #dc3545; padding: 15px; margin: 10px 0; color: #a71d2a;">
'''Объект <code>Рисунок</code>''' (<code>Image</code>) - позволяет добавить в отчет логотип фирмы, фотографию сотрудника или любую другую графическую информацию.  
<b>Внимание!</b><br/>
Это описание - для старой версии дизайнера документов (<b><i>AR</i></b>).<br/>
В ближайшее время страница будет обновлена на описание настройки в <b><i>FastReports</i></b>.
</div>


'''Изображение''' (<code>Image</code>) - элемент управления, отображающий изображение.
Источник изображения может быть выбран на панели свойств после того, как элемент управления Image будет размещен в отчете.


Может быть вставлен в отчет, добавлен в проект, сохранен в базе данных или к нему получен доступ через URL-адрес.  
Объект может отображать графику в форматах: <code>BMP</code>, <code>PNG</code>, <code>JPG</code>, <code>GIF</code>, <code>TIFF</code>, <code>ICO</code>, <code>EMF</code>, <code>WMF</code>.


Источник изображения может быть выбран на панели свойств после того, как элемент управления Image будет размещен в отчете.
Выглядит следующим образом:


Поддерживаемыми форматами изображений являются: <code>Base64 string</code>, <code>Byte[]</code>, <code>BMP</code>, <code>JPG</code>, <code>JPEG</code>, <code>JPE</code>,
[[Файл:picture_obj_1.png|center|border]]
<code>GIF</code>, <code>PNG</code>, <code>EMF</code>, <code>WMF</code>, <code>SVG</code>.


==Свойства==
==Источники==
Нажав на элемент управления изображением, можно задать его свойства на панели свойств.
Объект может показывать данные из следующих источников:
 
[[Файл:image.png|thumb|center]]


{|class="wikitable" style="margin:auto; background-color: #fff;"  
{|class="wikitable" style="margin:auto; background-color: #fff;"  
|-
|-
!Свойства
!Источник
!Описание
!Описание
|-
|-
|MIMEType
|'''Файл с картинкой'''
|выбор типа MIME из выпадающего списка
|Рисунок загружается из файла и хранится внутри отчета. Рисунок хранится в свойстве <code>Image</code>.
|-
|-
|Source
|'''Поле данных'''
|выбор источника изображения:
|Рисунок загружается из поля источника данных. Имя поля хранится в свойстве <code>DataColumn</code>.
*<code>External</code> - внешнего;
*<code>Embedded</code> - встроенного;
*<code>Database</code> - базы данных.
|-
|-
|Value
|'''Имя файла'''
|в зависимости от выбранного источника указывается путь к изображению
|Рисунок загружается из файла с указанным именем. Имя файла хранится в свойстве <code>ImageLocation</code>. Внутри отчета рисунок не хранится. Необходимо распространять файл рисунка вместе с отчетом.
|-
|-
|Sizing
|'''URL'''
|размер, который должен быть у изображения в элементе управления:
|Рисунок загружается из Интернета каждый раз, когда отчет строится. Внутри отчета рисунок не хранится. Адрес хранится в свойстве <code>ImageLocation</code>.
*<code>AutoSize</code> - элемент управления (рамка) сам меняет свой размер, чтобы подстроиться под реальные габариты изображения;
*<code>Fit</code> - изображение растягивается или сжимается точно под размер рамки; пропорции не сохраняются, поэтому картинка может выглядеть искаженной;
*<code>FitProportional</code> - изображение масштабируется так, чтобы полностью поместиться внутри рамки, сохраняя свои пропорции; пустые области возможны, если пропорции фото и рамки не совпадают;
*<code>Clip</code> - изображение отображается в оригинальном размере; если оно больше рамки, края просто обрезаются.
|-
|-
|}
|}


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


Недостатки:
[[Файл:picture_obj_2.png|center|border]]
*чем больше размер встраиваемого изображения, тем больше увеличивается размер файла отчета;
*при использовании изображения в нескольких отчетах и необходимости замены файла (например - новый логотип) - необходимо будет произвести замену каждого встроенного изображения.


===Добавление встроенного изображения===
[[Файл:picture_obj_3.png|center|border]]


*в дереве отчетов выбрать элемент <code>Report</code>;
[[Файл:picture_obj_4.png|center|border]]
*нажатием правой кнопки вызвать контекстное меню;
*выбрать пункт <code>Report Properties...</code>;


[[Файл:image_3.png|thumb|center]]
{|class="wikitable" style="margin:auto; background-color: #fff;"
 
|-
*в появившемся диалоговом окне <code>Report</code> во вкладке <code>Images</code> ввести
!Свойство
**в разделе <code>Image</code> - путь к изображению;
!Описание
**в разделе <code>Name</code> - имя, под которым сохранится изображение;
|-
**в разделе <code>Mime Type</code> - тип изображения из выпадающего списка.
|<code>Angle</code><br>'''''Угол поворота'''''
 
| Угол, на который нужно повернуть рисунок. Возможные значения для этого свойства - 0, 90, 180, 270.
[[Файл:image_2.png|thumb|center]]
|-
|<code>SizeMode</code><br>'''''Режим отображения'''''
|Режим отображения рисунка.
|-
|<code>Transparency</code><br>'''''Прозрачность'''''
|Степень прозрачности картинки. Свойство может иметь значение между 0 до 1. Значение 0 (по умолчанию) означает, что картинка непрозрачна.
|-
|<code>TransparentColor</code><br>'''''Прозрачный цвет'''''
|Цвет, который будет прозрачным при отображении картинки.
|-
|<code>Image</code><br>'''''Рисунок'''''
|Собственно рисунок.
|-
|<code>DataColumn</code><br>'''''Поле данных'''''
|Поле данных, из которого загружать рисунок.
|-
|<code>ImageLocation</code><br>'''''Месторасположение рисунка'''''
|Свойство может содержать имя файла или URL. Рисунок будет загружен из указанного места при построении отчета.
|-
|<code>Padding</code><br>'''''Отступы'''''
|Свойство позволяет задать отступы рисунка от краев объекта, в пикселах.
|-
|<code>ShowErrorImage</code><br>'''''Показывать ошибку'''''
|Показывает значок "Нет рисунка" в случае, если рисунок пустой. Это свойство имеет смысл использовать, если рисунок загружается из Интернета.
|-
|}

Версия от 01:23, 15 октября 2026

Объект Рисунок (Image) - позволяет добавить в отчет логотип фирмы, фотографию сотрудника или любую другую графическую информацию.

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

Объект может отображать графику в форматах: BMP, PNG, JPG, GIF, TIFF, ICO, EMF, WMF.

Выглядит следующим образом:

Источники

Объект может показывать данные из следующих источников:

Источник Описание
Файл с картинкой Рисунок загружается из файла и хранится внутри отчета. Рисунок хранится в свойстве Image.
Поле данных Рисунок загружается из поля источника данных. Имя поля хранится в свойстве DataColumn.
Имя файла Рисунок загружается из файла с указанным именем. Имя файла хранится в свойстве ImageLocation. Внутри отчета рисунок не хранится. Необходимо распространять файл рисунка вместе с отчетом.
URL Рисунок загружается из Интернета каждый раз, когда отчет строится. Внутри отчета рисунок не хранится. Адрес хранится в свойстве ImageLocation.


Файл:Picture obj 3.png
Свойство Описание
Angle
Угол поворота
Угол, на который нужно повернуть рисунок. Возможные значения для этого свойства - 0, 90, 180, 270.
SizeMode
Режим отображения
Режим отображения рисунка.
Transparency
Прозрачность
Степень прозрачности картинки. Свойство может иметь значение между 0 до 1. Значение 0 (по умолчанию) означает, что картинка непрозрачна.
TransparentColor
Прозрачный цвет
Цвет, который будет прозрачным при отображении картинки.
Image
Рисунок
Собственно рисунок.
DataColumn
Поле данных
Поле данных, из которого загружать рисунок.
ImageLocation
Месторасположение рисунка
Свойство может содержать имя файла или URL. Рисунок будет загружен из указанного места при построении отчета.
Padding
Отступы
Свойство позволяет задать отступы рисунка от краев объекта, в пикселах.
ShowErrorImage
Показывать ошибку
Показывает значок "Нет рисунка" в случае, если рисунок пустой. Это свойство имеет смысл использовать, если рисунок загружается из Интернета.