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

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

Материал из Химсофт Вики
 
(не показано 17 промежуточных версий этого же участника)
Строка 1: Строка 1:
'''Изображение''' (<code>Image</code>) - элемент управления, отображающий изображение.
'''Объект <code>Рисунок</code>''' (<code>Image</code>) - позволяет добавить в отчет логотип фирмы, фотографию сотрудника или любую другую графическую информацию. Выглядит следующим образом:


Может быть вставлен в отчет, добавлен в проект, сохранен в базе данных или к нему получен доступ через URL-адрес.  
[[Файл:picture_obj_1.png|center|border]]


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


Поддерживаемыми форматами изображений являются: <code>Base64 string</code>, <code>Byte[]</code>, <code>BMP</code>, <code>JPG</code>, <code>JPEG</code>, <code>JPE</code>,
==Виды источников==
<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> - изображение отображается в оригинальном размере; если оно больше рамки, края просто обрезаются.
|-
|-
|}
|}


==Встроенное изображение==
==Выбор источника==
Преимущество использования встроенного изображения заключается в том, что при перемещении отчета между проектами нет отдельного файла изображения, который можно было бы найти или отслеживать.  
Чтобы выбрать один из источников данных для рисунка, сделайте двойной щелчок мышью на объекте. Вы увидите редактор объекта <code>Рисунок</code>:
 
[[Файл:picture_obj_2.png|center|border]]
 
Варианты подключения объекта к полю данных:
*перетащить нужное поле из окна <code>Данные</code> на страницу отчета с помощью мыши (<code>drag&drop</code>);
*нажать мышкой на маленькой стрелочке в верхнем правом углу объекта и в открывшемся списке выбрать нужное поле:
[[Файл:data_field_view_2.png|center|border]]


Недостаток заключается в том, что чем больше размер встраиваемого изображения, тем больше увеличивается размер файла отчета.
==Режим отображения рисунка==
В контекстном меню объекта можно настроить режим отображения рисунка:
*<code>AutoSize</code> (''Авторазмер'') - объект принимает размеры рисунка;
*<code>CenterImage</code> (''Центрировать'') - рисунок центрируется внутри объекта;
*<code>Normal</code> (''Нормальный'') - рисунок выводится в левом верхнем углу объекта без масштабирования;
*<code>StretchImage</code> (''Растянуть'') - рисунок растягивается до размеров объекта. Пропорции рисунка не соблюдаются.
*<code>Zoom</code> (''Масштабировать'') - рисунок растягивается до размеров объекта с соблюдением пропорций.


[[Файл:image_2.png|thumb|center]]
Различия между режимами показаны на следующем рисунке:
 
[[Файл:picture_obj_4.png|center|border]]
 
==Свойства объекта==
Объект имеет следующие свойства:
 
{|class="wikitable" style="margin:auto; background-color: #fff;"
|-
!Свойство
!Описание
|-
|<code>Angle</code><br>'''''Угол поворота'''''
| Угол, на который нужно повернуть рисунок. Возможные значения для этого свойства - 0, 90, 180, 270.
|-
|<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:58, 15 октября 2026

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

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

Виды источников

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

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

Выбор источника

Чтобы выбрать один из источников данных для рисунка, сделайте двойной щелчок мышью на объекте. Вы увидите редактор объекта Рисунок:

Варианты подключения объекта к полю данных:

  • перетащить нужное поле из окна Данные на страницу отчета с помощью мыши (drag&drop);
  • нажать мышкой на маленькой стрелочке в верхнем правом углу объекта и в открывшемся списке выбрать нужное поле:

Режим отображения рисунка

В контекстном меню объекта можно настроить режим отображения рисунка:

  • AutoSize (Авторазмер) - объект принимает размеры рисунка;
  • CenterImage (Центрировать) - рисунок центрируется внутри объекта;
  • Normal (Нормальный) - рисунок выводится в левом верхнем углу объекта без масштабирования;
  • StretchImage (Растянуть) - рисунок растягивается до размеров объекта. Пропорции рисунка не соблюдаются.
  • Zoom (Масштабировать) - рисунок растягивается до размеров объекта с соблюдением пропорций.

Различия между режимами показаны на следующем рисунке:

Свойства объекта

Объект имеет следующие свойства:

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