### 关于 `win.ImageList` 和 `DPI Scale` 的用法 #### 使用 `ImageList` 控件 在 Windows Forms (WinForms) 中，`ImageList` 是一种用于存储图像集合的控件。它可以与诸如 `ListView` 或 `TreeView` 等其他控件一起使用来显示图标。 以下是创建并配置 `ImageList` 的基本方法： ```csharp // 创建一个新的 ImageList 实例 System.Windows.Forms.ImageList imageList = new System.Windows.Forms.ImageList(); // 设置图像大小（宽度和高度） imageList.ImageSize = new Size(16, 16); // 添加颜色深度设置 imageList.ColorDepth = ColorDepth.Depth32Bit; // 将图片添加到 ImageList 中 imageList.Images.Add(Image.FromFile("icon1.png")); imageList.Images.Add(Image.FromFile("icon2.png")); // 如果需要移除某个特定索引处的图片 imageList.Images.RemoveAt(0); ``` 上述代码展示了如何初始化一个 `ImageList` 并向其中添加图片[^1]。 #### 处理 DPI 缩放 (`dpiScale`) 当应用程序运行在高 DPI 显示器上时，Windows 自动调整 UI 元素的比例以保持清晰度。然而，在某些情况下可能需要手动处理 DPI 缩放逻辑。可以通过以下方式实现自定义缩放行为： ##### 获取当前 DPI 值 通过 P/Invoke 调用 GDI 函数可以查询屏幕的实际 DPI 值: ```csharp using System.Runtime.InteropServices; using System.Drawing; public class DpiHelper { [DllImport("gdi32.dll")] private static extern int GetDeviceCaps(IntPtr hdc, int nIndex); public enum DeviceCap { LOGPIXELSX = 88, LOGPIXELSY = 90 } public static float GetDpiX(Graphics graphics){ IntPtr dc = graphics.GetHdc(); try{ return GetDeviceCaps(dc, (int)DeviceCap.LOGPIXELSX); } finally{ graphics.ReleaseHdc(dc); } } public static float GetDpiY(Graphics graphics){ IntPtr dc = graphics.GetHdc(); try{ return GetDeviceCaps(dc, (int)DeviceCap.LOGPIXELSY); } finally{ graphics.ReleaseHdc(dc); } } } ``` 调用此帮助类中的静态方法即可获得水平方向上的 DPI 数值以及垂直方向上的数值[^4]。 ##### 应用程序范围内的 DPI 支持声明 为了使 WinForm 应用能够正确响应系统的 DPI 变化，需修改应用清单文件(app.manifest)，确保启用了自动缩放功能或者完全控制整个过程。例如启用感知模式如下所示： ```xml <application xmlns="urn:schemas-microsoft-com:asm.v3"> <windowsSettings> <!-- 启用每监视器 DPI 感知 --> <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">perMonitorV2</dpiAwareness> </windowsSettings> </application> ``` 这样做的目的是让操作系统知道您的应用程序支持不同分辨率下的渲染效果优化[^3]。 #### 结合实例展示两者配合工作流程 下面是一个简单的例子说明如何在一个窗体中加载一组图标并通过考虑 DPI 来动态调整它们的位置尺寸等属性。 ```csharp private void Form1_Load(object sender, EventArgs e) { // 初始化 ImageList this.imageList1.ImageSize = new Size((int)(16 * scaleFactor), (int)(16 * scaleFactor)); foreach(var imgPath in Directory.GetFiles(@"C:\Icons\", "*.png")) { Bitmap bmp = new Bitmap(imgPath); // 根据 DPI 计算合适的大小再加入列表 using(Graphics g = Graphics.FromImage(bmp)){ double scale = Math.Min(DpiHelper.GetDpiX(g)/96d , DpiHelper.GetDpiY(g)/96d ); if(scale !=1 ){ var newSize=new SizeF(bmp.Width*scale,bmp.Height*scale); bmp=ResizeBitmap(new Rectangle(Point.Empty,(Size)newSize.ToSize()),bmp); } } this.imageList1.Images.Add(bmp); } listView1.LargeImageList=this.imageList1 ; } /// 图片重设函数 static Bitmap ResizeBitmap(Rectangle bounds,Bitmap original){ Bitmap result=(Bitmap )original.Clone(bounds,original.PixelFormat); return result; } ``` 以上代码片段演示了基于 DPI 进行适当比例变换之后才把位图对象存入 `ImageList` 集合之中[^2]。 ---