基于.NET的Windows窗体编程之WinForms图像控件

2026年7月7日
| 没有评论

在实际应用开发中，图像是程序不可获取的一部分，合理的利用图像不仅可以点缀美化软件，还可以起到事半功倍的效果，今天我们以一些简单的小例子，简述基于.NET的Windows窗体编程中图像控件的相关应用，仅供学习分享使用，如有不足之处，还请指正。

 

概述

 

在WinForms开发框架中，与图像相关的控件主要有两个：

  • PictureBox，控件用于以位图、GIF、JPEG、元文件或图标格式显示图形。
  • ImageList，组件用于存储图像，然后可由控件显示。 图像列表允许为单个一致的图像目录编写代码。

 

PictureBox

 

PictureBox 控件用于以位图、GIF、JPEG、元文件或图标格式显示图形，PictureBox控件的关键属性如下：

  • Image，通过在运行时或设计时设置此属性，可以让控件显示图片。
  • ImageLocation 属性来指定图像的位置。
  • Load 方法同步加载图像。
  • LoadAsync 方法异步加载图像。 
  • SizeMode，图像的大小和位置的处理模式，它共有四个值，默认为Normal：
    • Normal 表示图像放置在控件的左上角;如果图像大于控件，则其下边缘和右边缘被剪裁。 
    • CenterImage 表示图像在控件中居中，如果图像大于控件，则图像的外部边缘会被裁剪。 
    • AutoSize 控件的大小调整为图像的大小。 
    • StretchImage 表示将图像的大小调整为控件的大小。

首先拖动控件PictureBox到Form表单中，并命名为pbImage，在Visual Studio设计器中，PictureBox控件为虚线边框的正方形控件，可以在设计时通过Image属性设置控件显示的图片，所见即所得，如下所示：

运行示例，效果如下所示：

在上述示例中，PictureBox控件的SiteMode为Normal，图像大小小于PictureBox控件的大小，没有填满控件，剩余部分显示控件的背景色（Yellow）。

PictureBox控件不仅可以在设计器中添加图片，还可以通过C#代码加载控件，在Form的Load事件中，为PictureBox控件赋值，如下所示：

private void FrmImage_Load(object sender, EventArgs e)
{
    string imageFile = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Constellation", "02.jpg");
    //方法一，为Image属性赋值Image对象实例
    //this.pbImage.Image = Image.FromFile(imageFile);
    //方法二，为ImageLocation属性赋值图片路径，并调用Load方法
    this.pbImage.ImageLocation = imageFile;
    this.pbImage.Load();
}

运行示例，效果如下所示：

订阅FormClosed事件，并在事件中释放图像资源，主要释放图像使用的内存，然后清除图形。 如果内存管理出现问题，垃圾回收稍后将释放内存。代码如下所示：

private void FrmImage_FormClosed(object sender, FormClosedEventArgs e)
{
    if (pbImage.Image != null)
    {
        pbImage.Image.Dispose();
        pbImage.Image = null;
    }
}

当Form表单关闭时，会触发FormClosed事件，执行图像的释放。

 

ImageList

 

ImageList 组件用于存储图像，然后可由控件显示，图像列表允许为单个一致的图像目录编写代码。组件的关键属性主要有以下几个：

  • Images，表示包含关联控件要使用的图片。 每个图像都可以通过其索引值或键访问。 
  • ColorDepth 属性确定图像呈现的颜色数。
  • ImageSize 属性设置图像将以相同的大小显示，更大的图像将被缩放以适应。

首先拖动ImageList控件到Form表单中，并命名为imgList，ImageList控件并不会直接显示在页面中，而是显示在组件托盘中，一般与其他控件一起使用，如ListView。

首先在Form的Load事件中为ImageList控件添加图像，并将PictureBox控件的图像设置为ImageList的第一张图像。如下所示：

private void FrmImage_Load(object sender, EventArgs e)
{
    var images = Directory.GetFiles(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Constellation"));
    images = images.OrderBy(item => item).ToArray();//排序
    foreach (var image in images)
    {
        this.imgList.Images.Add(Image.FromFile(image));
    }
    this.imgList.ImageSize = new Size(200, 200);
    this.pbImage.Image = this.imgList.Images[0];
    this.pbImage.SizeMode = PictureBoxSizeMode.CenterImage;
    this.imageIndex = 0;
}

然后添加两个按钮，分别用于切换前一张，下一张图片，如下所示：

private int imageIndex = 0;

private void btnPrev_Click(object sender, EventArgs e)
{
    if (imageIndex <= 0)
    {
        return;
    }
    imageIndex--;
    this.pbImage.Image = this.imgList.Images[imageIndex];
}

private void btnNext_Click(object sender, EventArgs e)
{
    if (imageIndex >= this.imgList.Images.Count - 1)
    {
        return;
    }
    imageIndex++;
    this.pbImage.Image = this.imgList.Images[imageIndex];
}

上述示例提前判断当前图片的索引是否是第一张，和最后一张，主要是为了防止数组越界。

运行示例，效果图像所示：

由于Images本身是图像列表类型，可以通过Images的Clear方法，Remove方法删除图片。如下所示：

// 删除指定图片.
imgList.Images.Remove(myImage);
//清空所有图片.
imgList.Images.Clear();

还可以通过Key进行添加和删除图片，如下所示：

//按Key添加图片
System.Drawing.Image myImage = Image.FromFile(System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal)+ @"\Image.gif");
imgList.Images.Add("myPhoto", myImage);
//按key删除图片.
imgList.Images.RemoveByKey("myPhoto");

源码获取

关于本系列的完整代码，可以通过gitee上的库进行获取：https://gitee.com/ahsiang/winforms

 

以上就是《基于.NET的Windows窗体编程之WinForms图像控件》的全部内容，旨在抛砖引玉，一起学习，共同进步！！！

文章摘自：https://www.cnblogs.com/hsiang/p/21122407

.net, abp