SmPictureBox(Sm图片)

SmPictureBox(图片)

SmPictureBox继承自PictureBox，实现了IControl、IBindingControl 接口。

PictureBox通常用于显示位图、图元文件、图标、JPEG、GIF 或 PNG 文件中的图形。

将 Image 属性设置为 Image 要在设计时或运行时显示的属性。也可以通过设置ImageLocation属性并使用该方法以异步方式LoadAsync同步Load加载图像来指定图像。

注意：如果要在多个 PictureBox 控件中使用同一个映像，请为每个 PictureBox控件创建映像的克隆。从多个控件访问同一映像会导致发生异常。

该 SizeMode 属性设置为枚举中的 PictureBoxSizeMode 值，控制图像在显示区域中的剪辑和定位。可以使用属性在运行时 ClientSize 更改显示区域的大小。

默认情况下， PictureBox 控件不带任何边框显示。可以使用属性提供标准边框或三维边框 BorderStyle ，以便将图片框与窗体的其余部分区分开来，即使它不包含图像也是如此。该 PictureBox 控件不是可选的控件，这意味着它无法接收输入焦点。

属性

属性名称中文名称说明

ErrorImage 错误图片获取或设置在图像加载过程中发生错误时，或者图像加载取消时要显示的图像。

FixedPreOrExtraPath 固定前后缀获得或设置图片的固定前缀或后缀。与ImagePath属性一起拼接成一个正常的本地路径或网络图片地址。例：http:\\www.baidu.com\pic\{0}.jpg

FTPClient FTPClient 返回或设置当前图片控件所关联的FTP设置。

Image 图片获取或设置由 PictureBox 显示的图像。

ImageLocation 图片地址获取或设置要在 PictureBox 中显示的图像的路径或 URL。

ImagePath 图片路径字符型，返回或设置当前图片控件显示图片的路径。我们绑定的字段就是这个属性。这个属性的值跟表字段中的值是一致的。这里可以是完整的URL地址，也可以是完整的本地图片路径，也可以是单纯的文件名，结合表属性中显示样式中的“显示图片”设置、“图片字典”以及扩展列类型中“ImagesManager”规范都可以正常显示图片。

InitialImage 加载图片获取或设置在加载主图像时显示在 PictureBox 控件中的图像。

SizeMode 图片显示模式指示如何显示图像。PictureBoxSizeMode 值之一。默认值为 Normal。

WaitOnLoad 等待加载获取或设置一个值，该值指示图像是否是同步加载的。

PictureBoxSizeMode枚举枚举值说明

AutoSize 2 调整 PictureBox 大小，使其等于所包含的图像大小。

CenterImage 3 如果 PictureBox 比图像大，则图像将居中显示。如果图像比 PictureBox 大，则图片将居于 PictureBox 中心，而外边缘将被剪裁掉。

Normal 0 图像被置于 PictureBox 的左上角。如果图像比包含它的 PictureBox 大，则该图像将被剪裁掉。

StretchImage 1 PictureBox 中的图像被拉伸或收缩，以适合 PictureBox 的大小。

Zoom 4 图像大小按其原有的大小比例被增加或减小。

SmPictureBox被设计成了一个可绑定的控件，我们可以显示“图片字典”、显示样式中的“显示图片”以及扩展列类型中“ImagesManager”规范中显示的图片。由于ImagePath支持的显示图片结合的东西太多，判断的东西也会增多。所以效率上会差一点，不适合在同个窗口大量使用。如果想效率高一点的话，可以考虑ImageLocation属性，结合WaitOnLoad属性可以对图片实现异步加载，大大增加图片加载的效率。但是ImageLocation属性只支持常规的完整的URL地址或完整的本地图片路径。

下图就是使用图片控件绑定图片字典，显示数据状态。

属性名称	中文名称	说明
ErrorImage	错误图片	获取或设置在图像加载过程中发生错误时，或者图像加载取消时要显示的图像。
FixedPreOrExtraPath	固定前后缀	获得或设置图片的固定前缀或后缀。与ImagePath属性一起拼接成一个正常的本地路径或网络图片地址。例：http:\\www.baidu.com\pic\{0}.jpg
FTPClient	FTPClient	返回或设置当前图片控件所关联的FTP设置。
Image	图片	获取或设置由 PictureBox 显示的图像。
ImageLocation	图片地址	获取或设置要在 PictureBox 中显示的图像的路径或 URL。
ImagePath	图片路径	字符型，返回或设置当前图片控件显示图片的路径。我们绑定的字段就是这个属性。这个属性的值跟表字段中的值是一致的。这里可以是完整的URL地址，也可以是完整的本地图片路径，也可以是单纯的文件名，结合表属性中显示样式中的“显示图片”设置、“图片字典”以及扩展列类型中“ImagesManager”规范都可以正常显示图片。
InitialImage	加载图片	获取或设置在加载主图像时显示在 PictureBox 控件中的图像。
SizeMode	图片显示模式	指示如何显示图像。PictureBoxSizeMode 值之一。默认值为 Normal。
WaitOnLoad	等待加载	获取或设置一个值，该值指示图像是否是同步加载的。

PictureBoxSizeMode枚举	枚举值	说明
AutoSize	2	调整 PictureBox 大小，使其等于所包含的图像大小。
CenterImage	3	如果 PictureBox 比图像大，则图像将居中显示。如果图像比 PictureBox 大，则图片将居于 PictureBox 中心，而外边缘将被剪裁掉。
Normal	0	图像被置于 PictureBox 的左上角。如果图像比包含它的 PictureBox 大，则该图像将被剪裁掉。
StretchImage	1	PictureBox 中的图像被拉伸或收缩，以适合 PictureBox 的大小。
Zoom	4	图像大小按其原有的大小比例被增加或减小。