> For the complete documentation index, see [llms.txt](https://wfsys.gitbook.io/workflow-web-forms-syntax/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wfsys.gitbook.io/workflow-web-forms-syntax/workflow_webforms/objects/picturebox.md). # PictureBox ## Шаблон PictureBox Перечень всех возможных тэгов объекта: ```xml ``` ## Описание PictureBox ```xml ``` ### Получение значения PictureBox Значением PictureBox считается источник текущего отображаемого изображения. ```xml ``` ### Задание значения PictureBox Значение объекта: любое значение будет интерпретировано как источник. ```xml ``` ## Тэги, специфичные для PictureBox ### SizeMode Название типа размера изображения. Необязательный тэг. Ожидается название одного из типов размеров изображения:
Normal

Изображение не масштабируется. Помещается в левом верхнем углу.
Если размер PictureBox больше размера изображения - изображение помещается в центре PictureBox.

Если размер изображения больше размера PictureBox, его края будут обрезаны.

StretchImage

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

Пропорции изображения не сохраняются.

None

Изображение не масштабируется. Помещается в левом верхнем углу.

Если размер изображения больше размера PictureBox, его края будут обрезаны.

CenterImageИзображение не масштабируется. Помещается в центре.
Если размер изображения больше размера PictureBox, его края будут обрезаны.
ZoomРазмер изображения изменяется, чтобы в соответствовать высоте или ширине PictureBox.
Пропорции изображения сохраняются.
По умолчанию используется значение Zoom. ```xml Zoom ``` ### NullImage Источник изображения, которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL. Необязательный тэг. Ожидается источник изображения. Если тэг `` отсутствует, то используется системное изображение. ```xml Images\NullImage.png ``` ### Image Источник изображения, которое будет использоваться в качестве начального отображаемого изображения при загрузке формы. Необязательный тэг. Ожидается источник изображения. ```xml http://wfsys.ru/image.bmp ``` #### Источники изображений 1. Сокращенный путь до файла - например, "Images\Sample.png" (в качестве исходной папки будет взята папка с расположением формы, на которой описано данное поле). 2. Полный путь до файла изображения на Engine (в случае, если Engine и Workflow WebForms запущены на одном компьютере и соответствующая настройка указана в конфигурационном файле WebForms). 3. Ссылка на интернет-ресурс по протоколам http\://, https\:// или ftp\:// - например, "". 4. GUID файла, расположенного на сервере, - например, "cbed3d33-7591-49ff-8119-8ad7e3c81599". ## Get-проперти для получения свойств ### SizeMode Возвращает название типа размера изображения. ```xml ``` ### NullImage Возвращает [источник изображения](#image_sources), которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL. ```xml ``` ### Image Возвращает [источник изображения](#image_sources), которое будет использоваться в качестве начального отображаемого изображения при загрузке формы. ```xml ``` ## Set-проперти для динамического задания свойств ### SizeMode Задает название типа размера изображения. Ожидается название одного из типов размеров изображения. ```xml StretchImage ``` ### NullImage Задает [источник изображения](#image_sources), которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL. Ожидается источник изображения. ```xml \\SHARE\Images\NullImage.png ``` ### Image Задает [источник изображения](#image_sources), которое будет использоваться в качестве начального отображаемого изображения при загрузке формы. Ожидается источник изображения. ```xml guid://26c7d4b6-2b4a-48f3-bde1-def012932219 ```