PictureBox 图片显示控件

PictureBox 图片显示控件

PictureBox 是一个用来呈现图片的控件。

设置图片

可以在属性窗口中直接设置 Image 属性选择图片文件，也可以在后台代码中动态更改。

图片来源可以是 ImageList 中的图片，也可以直接从文件读取。

从文件读取并显示

private void button3_Click(object sender, EventArgs e)
{
    FileStream fs = new FileStream(@"C:\Users\86186\Desktop\新建文件夹 (4)\noaccept.png", FileMode.Open,
                                     FileAccess.Read); // 获取图片文件流
    Image img = Image.FromStream(fs); // 文件流转换成Image格式

    this.pictureBox1.Image = img;
    fs.Close(); // 使用完记得关闭文件流
}Code language: JavaScript (javascript)

从 ImageList 获取图片

this.pictureBox1.Image = this.imageList1.Images[0];Code language: JavaScript (javascript)

从资源文件加载

this.pictureBox1.Image = Properties.Resources.noaccept;Code language: JavaScript (javascript)

常用属性

属性	说明
Image	显示的图片对象
ImageLocation	图片文件路径，设置后自动加载
SizeMode	图片显示模式
BorderStyle	边框样式（None、FixedSingle、Fixed3D）
InitialImage	加载远程图片时显示的占位图
ErrorImage	加载失败时显示的图片
WaitOnLoad	是否同步加载图片

SizeMode 显示模式

模式	说明
Normal	左上角对齐，图片保持原始大小
StretchImage	拉伸填充整个控件（可能变形）
AutoSize	控件自动调整为图片大小
CenterImage	居中显示，超出部分裁剪
Zoom	按比例缩放，完整显示图片（不变形，推荐）

this.pictureBox1.SizeMode = PictureBoxSizeMode.Zoom;
this.pictureBox1.BorderStyle = BorderStyle.FixedSingle;Code language: JavaScript (javascript)

直接设置图片路径（简化写法）

this.pictureBox1.ImageLocation = @"C:\Users\86186\Desktop\noaccept.png";Code language: JavaScript (javascript)

清除图片

this.pictureBox1.Image = null;Code language: JavaScript (javascript)

常用事件

事件	说明
Click	单击图片时触发
DoubleClick	双击图片时触发
LoadCompleted	图片加载完成时触发
LoadProgressChanged	图片加载进度改变时触发