# 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 ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wfsys.gitbook.io/workflow-web-forms-syntax/workflow_webforms/objects/picturebox.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.