PictureBox

Графический объект; поле с изображением.

Шаблон PictureBox

Перечень всех возможных тэгов объекта:

<MyObject Name="" Type="PictureBox" Assembly="BaseControls" ChangeForm="">
  <!--Тэги, общие для всех графических объектов-->
  <Top></Top>
  <Bottom></Bottom>
  <Left></Left>
  <Right></Right>
  <Height></Height>
  <Width></Width>
  <FontStyle></FontStyle>
  <ForeColor></ForeColor>
  <BackColor></BackColor>
  <Enabled></Enabled>
  <Visible></Visible>
  <Hint></Hint>
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для PictureBox-->
  <SizeMode></SizeMode>
  <NullImage></NullImage>
  <Image></Image>
</MyObject>

Описание PictureBox

<MyObject Name="PictureBoxName" Type="PictureBox" Assembly="BaseControls">
  <!--Тэги, общие для всех графических объектов-->
  <!--Тэги, специфичные для PictureBox-->
</MyObject>

Получение значения PictureBox

Значением PictureBox считается источник текущего отображаемого изображения.

<Object Name="PictureBoxName" />

Задание значения PictureBox

Значение объекта: любое значение будет интерпретировано как источник.

<Object Name="PictureBoxName"></Object>

Тэги, специфичные для PictureBox

SizeMode

Название типа размера изображения.

Необязательный тэг. Ожидается название одного из типов размеров изображения:

Normal	Изображение не масштабируется. Помещается в левом верхнем углу. Если размер PictureBox больше размера изображения - изображение помещается в центре PictureBox. Если размер изображения больше размера PictureBox, его края будут обрезаны.
StretchImage	Изображение растягивается или сжимается, чтобы в точности соответствовать размеру PictureBox. Пропорции изображения не сохраняются.
None	Изображение не масштабируется. Помещается в левом верхнем углу. Если размер изображения больше размера PictureBox, его края будут обрезаны.
CenterImage	Изображение не масштабируется. Помещается в центре. Если размер изображения больше размера PictureBox, его края будут обрезаны.
Zoom	Размер изображения изменяется, чтобы в соответствовать высоте или ширине PictureBox. Пропорции изображения сохраняются.

По умолчанию используется значение Zoom.

<SizeMode>Zoom</SizeMode>

NullImage

Источник изображения, которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL.

Необязательный тэг. Ожидается источник изображения.

Если тэг <NullImage> отсутствует, то используется системное изображение.

<NullImage>Images\NullImage.png</NullImage>

Image

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

Необязательный тэг. Ожидается источник изображения.

<Image>http://wfsys.ru/image.bmp</Image>

Источники изображений

1. Сокращенный путь до файла - например, "Images\Sample.png" (в качестве исходной папки будет взята папка с расположением формы, на которой описано данное поле).

2. Полный путь до файла изображения на Engine (в случае, если Engine и Workflow WebForms запущены на одном компьютере и соответствующая настройка указана в конфигурационном файле WebForms).

3. Ссылка на интернет-ресурс по протоколам http://, https:// или ftp:// - например, "http://wfsys.ru/sample.png".

4. GUID файла, расположенного на сервере, - например, "cbed3d33-7591-49ff-8119-8ad7e3c81599".

Get-проперти для получения свойств

SizeMode

Возвращает название типа размера изображения.

<Object Name="PictureBoxName">
  <Property Name="SizeMode" />
</Object>

NullImage

Возвращает источник изображения, которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL.

<Object Name="PictureBoxName">
  <Property Name="NullImage" />
</Object>

Image

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

<Object Name="PictureBoxName">
  <Property Name="Image" />
</Object>

Set-проперти для динамического задания свойств

SizeMode

Задает название типа размера изображения.

Ожидается название одного из типов размеров изображения.

<Object Name="PictureBoxName">
  <Property Name="SizeMode">StretchImage</Property>
</Object>

NullImage

Задает источник изображения, которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL.

Ожидается источник изображения.

<Object Name="PictureBoxName">
  <Property Name="NullImage">\\SHARE\Images\NullImage.png</Property>
</Object>

Image

Задает источник изображения, которое будет использоваться в качестве начального отображаемого изображения при загрузке формы.

Ожидается источник изображения.

<Object Name="PictureBoxName">
  <Property Name="Image">guid://26c7d4b6-2b4a-48f3-bde1-def012932219</Property>
</Object>