PictureBox
Графический объект; поле с изображением.
Шаблон PictureBox
Перечень всех возможных тэгов объекта:
Описание PictureBox
Получение значения
Значением PictureBox считается источник текущего отображаемого изображения.
Задание значения
Значение объекта: любое значение будет интерпретировано как источник.
Тэги, специфичные для PictureBox
SizeMode
Название типа размера изображения.
Необязательный тэг. Ожидается название одного из типов размеров изображения:
AutoSize
Изображение располагается в левом верхнем углу
CenterImage
Если поле больше изображения, то изображение отображается в центре; если изображение больше поля, то рисунок размещается в центре, а его внешние края обрезаются
Normal
Изображение размещается в верхнем левом углу; изображение располагается в центре, если размер поля больше, чем размер изображения
StretchImage
Изображение вытягивается или сужается, чтобы в точности соответствовать размеру
Zoom
Размер изображения увеличивается или уменьшается, сохраняя пропорции размеров
По умолчанию используется значение Zoom.
InitialImage
Источник изображения, которое будет использоваться в качестве изображения поля, пока в асинхронном режиме загружается требуемое. Начальная загрузка изображения из источника для <InitialImage>
всегда происходит синхронно, вне зависимости от значения свойства <WaitOnLoad>
.
Необязательный тэг. Ожидается источник изображения.
Если тэг <InitialImage>
отсутствует, то в момент загрузки требуемого изображения никаких изменений в поле не будет происходить.
ErrorImage
Источник изображения, которое будет использоваться в качестве изображения поля, если требуемое не было загружено. Начальная загрузка изображения из источника для <ErrorImage>
всегда происходит синхронно, вне зависимости от значения свойства <WaitOnLoad>
.
Необязательный тэг. Ожидается источник изображения.
Если тэг <ErrorImage>
отсутствует, то в случае ошибки загрузки требуемого изображения никаких изменений в поле не будет ничего происходить.
WaitOnLoad
Признак, определяющий, будет ли загрузка изображений происходить в синхронном режиме.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение False.
NullImage
Источник изображения, которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL.
Необязательный тэг. Ожидается источник изображения.
Если тэг <NullImage>
отсутствует, то в случае установки NULL-значения в поле не будет ничего происходить.
Image
Источник изображения, которое будет использоваться в качестве начального отображаемого изображения при загрузке формы.
Необязательный тэг. Ожидается источник изображения.
Если тэг <Image>
отсутствует, то в качестве начального изображения будет использовано первое изображения из списка, указанного в тэге <ImagesList>
.
Источники изображений
Сокращенный путь до файла - например, "Images\Sample.png" (в качестве исходной папки будет взята папка с расположением формы, на которой описано данное поле).
Полный путь до файла в формате UNC - например, "D:\sample.jpg" или "\SERVER\Images\sample.bmp".
Ссылка на интернет-ресурс по протоколам http://, https:// или ftp:// - например, "http://wfsys.ru/sample.png".
Ссылка на GUID файла, расположенного на сервере, - например, "guid://cbed3d33-7591-49ff-8119-8ad7e3c81599".
ImagesLoad
Тип загрузки изображений из списка, указанного в тэге <ImagesList>
.
Необязательный тэг. Значение тэга <ImagesLoad>
: не ожидается.
Если тэг <ImagesList>
отсутствует, то для атрибута Value
используется значение ByRequest.
Атрибуты тэга <ImagesLoad>
<ImagesLoad>
Value
Значение.
Обязательный атрибут. Ожидается название одного из типов загрузки изображений.
Типы загрузки изображений
ByRequest
Изображения будут загружаться только в том случае, если их требуется отобразить
All
Все изображения будут загружены при загрузке формы
ImagesList
Список источников изображений, которые будут использоваться в качестве изображений для установки в поле.
Необязательный тэг. Ожидается массив источников изображений.
Если тэг <ImagesList>
отсутствует, то в качестве начального изображения будет использовано изображение из источника, указанного в тэге <NullImage>
.
Get-проперти для получения свойств
SizeMode
Возвращает название типа размера изображения.
InitialImage
Возвращает источник изображения, которое будет использоваться в качестве изображения поля, пока в асинхронном режиме загружается требуемое.
ErrorImage
Возвращает источник изображения, которое будет использоваться в качестве изображения поля, если требуемое изображение не было загружено.
WaitOnLoad
Возвращает признак, определяющий, будет ли загрузка изображений происходить в синхронном режиме.
NullImage
Возвращает источник изображения, которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL.
Image
Возвращает источник изображения, которое будет использоваться в качестве начального отображаемого изображения при загрузке формы.
ImagesLoad
Возвращает тип загрузки изображений из списка, указанного в тэге <ImagesList>
.
ImagesList
Возвращает массив источников изображений, которые будут использоваться в качестве изображений для установки в поле.
Count
Возвращает общее количество изображений в списке <ImagesList>
.
CurrentImageIndex
Возвращает индекс отображаемого изображения (-1 - если установлено изображение из настройки <Image>
, 0 - если установлено изображение из настройки <NullImage>
, от 1 до N - если установлено изображение из списка <ImagesList>
, где N - общее количество изображений в этом списке).
CurrentImageSource
Возвращает источник отображаемого изображения.
CurrentRealImageSource
Возвращает источник изображения даже если это изображение не отображается, а отображается <ErrorImage>
.
IsCurrentImageSourceError
Возвращает True или False в зависимости от того, была ли ошибка в загрузке текущего изображения.
Set-проперти для динамического задания свойств
SizeMode
Задает название типа размера изображения.
Ожидается название одного из типов размеров изображения.
InitialImage
Задает источник изображения, которое будет использоваться в качестве изображения поля, пока в асинхронном режиме загружается требуемое.
Ожидается источник изображения.
ErrorImage
Задает источник изображения, которое будет использоваться в качестве изображения поля, если требуемое не было загружено.
Ожидается источник изображения.
WaitOnLoad
Задает признак, определяющий, будет ли загрузка изображений происходить в синхронном режим.
Ожидается логическое значение.
NullImage
Задает источник изображения, которое будет использоваться в качестве изображения поля, если значение поля установлено в NULL.
Ожидается источник изображения.
Image
Задает источник изображения, которое будет использоваться в качестве начального отображаемого изображения при загрузке формы.
Ожидается источник изображения.
ImagesList
Задает список источников изображений, которые будут использоваться в качестве изображений для установки в поле. При наличии в новом списке ранее загруженных изображений (по совпадению источника) их перезагрузка не происходит.
Ожидается массив источников изображений.
Open
Открывает файл изображения с индексом ImageIndex, предварительно при необходимости перезагрузив его в соответствии с признаком ForceRefresh.
Next
Устанавливает в качестве текущего следующее по списку <ImagesList>
изображение, предварительно при необходимости перезагрузив его в соответствии с признаком ForceRefresh.
Prev
Устанавливает в качестве текущего предыдущее по списку <ImagesList>
изображение, предварительно при необходимости перезагрузив его в соответствии с признаком ForceRefresh.
Show
Устанавливает в качестве текущего изображение с индексом ImageIndex, предварительно при необходимости перезагрузив его в соответствии с признаком ForceRefresh.
Refresh
Перезагружает изображение с индексом ImageIndex.
Last updated