Win32 Toolbar类DPI适配异常：ImageList图标自动缩放问题

我之前也踩过这个Win32 Toolbar图标DPI适配的坑，明明资源里备好了对应尺寸的图标，结果还是被强制缩放变形，核心问题在于**ImageList_AddIcon不会自动从多尺寸图标资源里挑选匹配的尺寸**，必须手动干预加载流程，下面是具体的解决步骤：

1. 先确保程序是DPI感知的 #

如果程序没声明DPI感知，系统会对整个窗口进行全局缩放，直接导致图标被拉伸。你可以通过两种方式设置：

• 在应用manifest中添加PerMonitorV2 DPI感知声明：

  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">true/PM</dpiAware>
      <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2, PerMonitor</dpiAwareness>
    </windowsSettings>
  </application>
  

• 或者在程序启动时调用API直接设置：

  SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2);
  

2. 创建对应尺寸的ImageList #

别用默认尺寸创建ImageList，必须明确指定与当前DPI匹配的icsize：

HIMAGELIST hImageList = ImageList_Create(icsize, icsize, ILC_COLOR32 | ILC_MASK, 0, 1);

这里ILC_COLOR32保证图标色彩保真，ILC_MASK负责处理透明通道，适配工具栏的背景样式。

3. 加载匹配尺寸的图标（关键步骤！） #

不要直接用LoadIcon或者把资源图标直接传入ImageList_AddIcon——这俩方法只会加载图标资源里的默认尺寸，然后强制缩放。改用LoadIconWithScaleDown函数，它会自动从多尺寸图标资源中挑选最匹配的尺寸，完全避免缩放：

HICON hScaledIcon = NULL;
// 从资源加载对应尺寸的图标，不会进行缩放
LoadIconWithScaleDown(hInstance, MAKEINTRESOURCE(IDI_YOUR_ICON), icsize, icsize, &hScaledIcon);
if (hScaledIcon) {
    ImageList_AddIcon(hImageList, hScaledIcon);
    DestroyIcon(hScaledIcon); // 用完记得销毁图标句柄，避免内存泄漏
}

如果你的系统版本低于Windows 8.1，也可以用LoadImage并指定具体尺寸：

HICON hIcon = (HICON)LoadImage(hInstance, MAKEINTRESOURCE(IDI_YOUR_ICON), 
                               IMAGE_ICON, icsize, icsize, LR_DEFAULTCOLOR);
if (hIcon) {
    ImageList_AddIcon(hImageList, hIcon);
    DestroyIcon(hIcon);
}

4. 配置Toolbar的图标和按钮尺寸 #

把创建好的ImageList关联到Toolbar后，还要明确设置图标和按钮的尺寸，确保工具栏能正确渲染：

// 关联ImageList到Toolbar
SendMessage(hToolbar, TB_SETIMAGELIST, 0, (LPARAM)hImageList);
// 设置图标尺寸为icsize x icsize
SendMessage(hToolbar, TB_SETBITMAPSIZE, 0, MAKELPARAM(icsize, icsize));
// 设置按钮尺寸（图标尺寸+边距，可根据需求调整数值）
SendMessage(hToolbar, TB_SETBUTTONSIZE, 0, MAKELPARAM(icsize + 8, icsize + 8));

5. 处理DPI变化事件 #

如果你的程序支持跨显示器DPI感知，当窗口移动到不同DPI的显示器时，需要响应WM_DPICHANGED消息，重新计算icsize、创建ImageList、加载图标并更新Toolbar：

case WM_DPICHANGED: {
    UINT newDpi = HIWORD(wParam);
    // 计算新的图标尺寸：以96DPI下的24px为基准按比例缩放
    int newIconSize = MulDiv(24, newDpi, 96);
    // 这里销毁旧的ImageList，重新执行步骤2-4的流程
    // ...
    return 0;
}

按照这个流程走，就能让工具栏在低DPI下显示24x24图标，高DPI下显示48x48图标，不会再出现强制缩放的问题了。

内容的提问来源于stack exchange，提问作者Andreas