Win32工具栏按钮图像顺序错乱且出现异常黑线问题排查

首先，结合你描述的「仅自制TBbuttons.bmp出问题，其他位图正常」的现象，核心问题大概率出在这张位图的制作细节上，代码也存在几个可以优化的小问题，下面分点说明：

一、位图文件本身的问题（核心原因） #

因为其他两张位图能正常显示，所以先聚焦你自制的TBbuttons.bmp：

• 4bpp索引色的调色板异常：4bpp索引位图依赖16色的标准调色板，如果制作时调色板缺失颜色、索引顺序错误，或者保存时被工具自动转换为其他格式（比如偷偷转成8bpp），工具栏解析时就会出现颜色失真、黑线或图像错位。你可以用系统自带的「画图」工具重新打开这张图，选择「另存为」→「16色位图」，覆盖原文件后再测试。
• 扫描线对齐问题：Win32要求位图的每一行字节数必须是4的倍数。你的位图是16px宽的4bpp图，每行字节数是(16/8)*4=8，刚好符合要求，但如果制作工具没有正确处理扫描线对齐，就会导致图像偏移，出现莫名的黑线。
• 按钮区域边界不干净：仔细检查每个16x16的按钮图像区域，确认顶部没有不小心绘制的1像素黑线，或者图像本身在区域内偏移了位置。

二、代码中的潜在优化点 #

虽然其他位图正常，但你的代码有几个细节需要修正，避免后续出现问题：

• TB_ADDBITMAP参数错误：你调用该消息时，第二个参数是要添加的位图数量，而不是结构体的大小计算值。虽然这次数值碰巧为1，但逻辑是错的，正确写法应该是：

  int idx = SendMessage(hToolBarWnd, TB_ADDBITMAP, 1, (LPARAM)&tbBitmap);
  

• 循环索引的健壮性优化：你的userButtons数组包含1个分隔符+10个按钮，循环i=1到10刚好覆盖所有按钮，但如果后续修改数组长度容易出越界问题，建议改成：

  int buttonCount = sizeof(userButtons)/sizeof(TBBUTTON);
  for (int i = 1; i < buttonCount; i++) { // 跳过第一个分隔符
      userButtons[i].iBitmap += idx;
  }
  

• 按钮尺寸匹配检查：确认你定义的BUTTON_WIDTH、BUTTON_HEIGHT、IMAGE_WIDTH、IMAGE_HEIGHT宏值都是16，和你的位图按钮尺寸完全一致，尺寸不匹配会导致图像拉伸或错位。

三、快速验证步骤 #

1. 用系统画图工具重新导出TBbuttons.bmp为16色位图，替换原文件后运行测试；
2. 右键查看TBbuttons.bmp的属性→详细信息，确认「位深度」是4，「宽度」160、「高度」16；
3. 临时把代码中的IDB_BITMAP1替换为其他正常位图的ID，验证代码逻辑是否能正常显示，排除代码问题。

总结来说，你遇到的问题主要是自制位图的格式或保存细节错误，代码的小问题不影响功能但需要修正，按照上面的步骤调整后应该能解决。

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