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

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

Материал из Химсофт Вики
Нет описания правки
 
(не показано 20 промежуточных версий этого же участника)
Строка 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>.
Объект может показывать данные из следующих источников:


Нажав на элемент управления изображением, можно задать его свойства на панели свойств.
{|class="wikitable" style="margin:auto; background-color: #fff;"
|-
!Источник
!Описание
|-
|'''Файл с картинкой'''
|Рисунок загружается из файла и хранится внутри отчета. Рисунок хранится в свойстве <code>Image</code>.
|-
|'''Поле данных'''
|Рисунок загружается из поля источника данных. Имя поля хранится в свойстве <code>DataColumn</code>.
|-
|'''Имя файла'''
|Рисунок загружается из файла с указанным именем. Имя файла хранится в свойстве <code>ImageLocation</code>. Внутри отчета рисунок не хранится. Необходимо распространять файл рисунка вместе с отчетом.
|-
|'''URL'''
|Рисунок загружается из Интернета каждый раз, когда отчет строится. Внутри отчета рисунок не хранится. Адрес хранится в свойстве <code>ImageLocation</code>.
|-
|}


[[Файл:image.png|thumb|center]]
==Выбор источника==
Чтобы выбрать один из источников данных для рисунка, сделайте двойной щелчок мышью на объекте. Вы увидите редактор объекта <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> (''Масштабировать'') - рисунок растягивается до размеров объекта с соблюдением пропорций.
 
Различия между режимами показаны на следующем рисунке:
 
[[Файл:picture_obj_4.png|center|border]]
 
==Свойства объекта==
Объект имеет следующие свойства:


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

Текущая версия от 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
Показывать ошибку
Показывает значок "Нет рисунка" в случае, если рисунок пустой. Это свойство имеет смысл использовать, если рисунок загружается из Интернета.