企业官网建设流程全解析

简介：在Windows界面开发中，工具栏是高频交互组件，而MFC的CToolBar常因资源类型、样式位和尺寸设置不当，导致图片不显示或文字错位。理解CToolBar底层基于Win32工具栏控件的原理，是自定义图片按钮和文字布局的关键——SetButtons定义按钮结构，CImageList承载图标，TBSTYLE_TEXT与TBSTYLE_LIST控制图文排列。掌握这些机制后，开发者可通过动态创建、系统图标复用及自绘扩展，灵活适配固定与动态按钮、多语言切换及高DPI场景。本文围绕CToolBar的图片加载链路、文字注入方式及样式控制，系统梳理从资源编辑器到代码实现的完整路径，并结合常见故障案例，提供可直接落地的工程实践方案，帮助读者高效打造简洁可靠的MFC工具栏。

1. CToolBar 自定义图片和文字：为什么照着教程写还是显示不对

做 MFC 界面的人早晚都要跟 CToolBar 打交道，尤其是想做出“带图标又带文字”的工具按钮时，大多数人会卡在同一个地方：位图明明加载了，按钮上却一片空白；或者文字怎么设置都不显示；更有甚者，图片和文字挤在一起，看起来像没对齐的半成品。这个标题里的“自定义图片及文字”看起来简单，实际牵扯到 CToolBar 的样式位、按钮状态、资源加载顺序、高 DPI 适配几条线。我最早做某跨平台系统时也被这玩意磨了一周，后来把整个调用链捋清楚才发现，问题根源经常不在“画图”这一步，而在资源类型、样式注册和尺寸设置这三者的配合上。这篇文章就把我从 CToolBar 的按钮数组构建、位图加载、文字注入到自绘扩展的完整方案讲清楚，代码可以直接拿去改，每一步都说明为什么这么做，以及最容易翻车的地方在哪里。

2. 自定义图片按钮：从资源编辑器到 SetButtons 的完整链路

2.1 为什么大多数教程教你“画位图”却还是显示空白

很多初学 MFC 的人拿到 CToolBar 的教程，第一步通常是：在资源编辑器里导入一张 BMP，然后调用LoadToolBar(IDR_TOOLBAR)，接着就等着按钮显示出来。但结果往往是工具栏出现了，按钮也有立体框，可框里根本没有图。这时候大多数人会怀疑是位图格式问题，其实真正的坑在于 MFC 的LoadToolBar是从.rc文件里解析TOOLBAR资源的，它按固定的“内部按钮 ID 表”去裁剪位图。如果你导入的是一个普通位图而不是TOOLBAR类型的资源，LoadToolBar完全可以返回成功，但它会认为位图是按“一个按钮对应一个固定宽度”切割的，而普通 BMP 的资源头里根本没有按钮宽度信息，于是切割出来的每一块都只包含左上角几个像素，视觉上就是空白。

另一种常见的做法是用SetBitmap指定一个 HBITMAP，再配合SetButtons告诉它按钮个数。这条路比LoadToolBar更直接，但很多人在这里翻车的原因是：SetBitmap使用的位图必须是一个“横向平铺的位图”，即 N 个按钮图标的像素从左到右连续排列。而很多初学者用某画图工具画了一个 16x16 的单独小图标，直接传给SetBitmap，CToolBar 却默认按GetButtonStyle中的TBSTYLE_AUTOSIZE去切，切出来的第一块就是整个位图，剩下按钮没有图像，于是只有第一个按钮有图，后面的全是空白。

所以在动手写代码前，必须先把概念立住：CToolBar 的图片来源可以是一个“图带”（image strips），也可以是一个CImageList。前者适合静态设计资源，后者适合运行时动态创建。我们下面两条路都讲，但你要先决定自己的场景——工具栏按钮数量是固定的，还是会在运行时增加或删除。固定用图带，动态用CImageList，这是选型的第一原则。

2.2 用 SetBitmap 和 LoadToolBar 的两种常规做法

先说最简单的LoadToolBar。要让它可靠工作，必须保证两点：第一，资源是真正的TOOLBAR类型而不是 BITMAP；第二，按钮 ID 数组与资源里定义的按钮顺序一致。一般我在.rc文件里看到的结构是这样的：

IDR_MAIN_TOOLBAR TOOLBAR 16, 16 BEGIN BUTTON ID_FILE_NEW SEPARATOR BUTTON ID_FILE_OPEN BUTTON ID_FILE_SAVE END

这段资源声明里16, 16表示每个按钮图片的宽度和高度。MFC 会在加载时把整张位图按这个尺寸切成若干块，切出来的顺序就是BEGIN块里BUTTON的顺序。注意SEPARATOR不会占图片位置，但它会在按钮数组里产生一个空项。如果你在代码里用SetButtons自己定义按钮数组，也要把分隔符的位置对应好，否则后续按钮的图片会整体错位一位。

// 工具栏加载：使用资源编辑器自动生成的 CToolBar if (!m_wndToolBar.Create(this, WS_CHILD | WS_VISIBLE | CBRS_TOP) || !m_wndToolBar.LoadToolBar(IDR_MAIN_TOOLBAR)) { TRACE("工具栏加载失败\n"); return -1; } // 必须调用以下两个函数让命令路由生效 m_wndToolBar.SetWindowText(_T("主工具栏")); m_wndToolBar.EnableDocking(CBRS_ALIGN_TOP);

代码逻辑：Create创建窗口和按钮条，LoadToolBar根据 TOOLBAR 资源自动建立按钮数组和位图关联。这两步不能换顺序。如果你在Create之后再改按钮样式，一定要调用SetWindowText只是为了给停靠时显示标题用，不是必须，但建议养成习惯。

参数说明：CBRS_TOP是停靠方向的初始值，不是最终停靠状态。EnableDocking是框架窗口调用的，不是给工具栏自己的。如果将来按钮文字不能显示，问题绝对不在这两行，而在后面要讲的样式上。

2.3 动态创建工具栏并给按钮贴图的代码示例与参数说明

需要动态创建工具栏时，LoadToolBar就不够灵活了。常见业务场景是：根据用户权限决定显示哪些按钮，甚至按钮图标不是来自资源而是来自外部 ICO 文件。这时我一般直接用CImageList管理图标。下面的代码演示一个最小可运行流程：

// 动态创建带图片的工具栏 CImageList imageList; imageList.Create(16, 16, ILC_COLOR32 | ILC_MASK, 5, 1); // 从资源或文件加载图标，追加到 ImageList HICON hIcon = (HICON)::LoadImage(AfxGetInstanceHandle(), MAKEINTRESOURCE(IDI_ICON_NEW), IMAGE_ICON, 16, 16, LR_DEFAULTCOLOR); imageList.Add(hIcon); // 继续添加其它图标... // 创建 CToolBar 控件开关窗口 m_wndToolBar.Create(this, WS_CHILD | WS_VISIBLE | CBRS_TOP, IDC_MY_TOOLBAR); m_wndToolBar.SetImageList(&imageList); m_wndToolBar.SetButtons(NULL, 3); // 先创建3个空按钮 // 为每个按钮设置命令ID，同时把按钮样式改成标准按下态 m_wndToolBar.SetButtonInfo(0, ID_FILE_NEW, TBBS_BUTTON, 0); m_wndToolBar.SetButtonInfo(1, ID_FILE_OPEN, TBBS_BUTTON, 1); m_wndToolBar.SetButtonInfo(2, ID_FILE_SAVE, TBBS_BUTTON, 2);

逻辑说明：CImageList必须是工具栏成员变量或static成员，不能是局部变量。因为SetImageList只是保存了指针，局部对象析构后原图像会失效。这是新手最容易犯的错，后面避坑章节再展开。SetButtons(NULL, 3)第一个参数传 NULL 的意思是“不预设按钮 ID，全部用默认 ID”，真正配置在SetButtonInfo中完成。SetButtonInfo三个参数分别是按钮索引、命令 ID、按钮样式和图片索引。

参数说明：ILC_COLOR32让图标支持带透明通道的 BMP，ILC_MASK则把点阵当透明掩码。对于现代视觉风格建议只需要ILC_COLOR32，不要混用 MASK，因为 MASK 会按单一颜色抠图，遇到图标抗锯齿边缘会留下黑边或白边。如果你从外部加载 PNG 转成 HICON，用 COLOR32 就够了。IMAGE_ICON加载出来的图标自带 alpha，视觉效果最干净。

这里有个细节：SetButtonInfo的第三个参数TBBS_BUTTON是普通按钮，如果要做SEPARATOR或TBBS_CHECKBOX，在动态创建时也用同一个函数，你把样式位组合传进去就行。图片索引从 0 开始，对应CImageList里的顺序，千万别传混淆。

3. 让文字显示出来：按钮文字、命令提示与多语言的土办法

3.1 为什么文字总是不出现：TBSTYLE_TEXT 和 SetButtonText 的关系

工具栏按钮文字是 MFC 里一个比较拧巴的功能。你给按钮调用了SetButtonText，运行起来却什么字都看不到。这几乎可以断定是按钮条本身没有启用TBSTYLE_TEXT样式。在 Win32 工具栏控件中，SetButtonText只是写入了一个字符缓冲，但控件的绘制逻辑在没有TBSTYLE_TEXT时默认不绘制文字。MFC 的 CToolBar 在Create时并不会自动替你把文字样式加上，即使工具栏资源里定义了文字，也需要代码里明确设置。

另一个容易忽略的点是：如果工具栏按钮同时有图标和文字，而样式里没有启用TBSTYLE_LIST，那么图片和文字就会重叠显示，文字直接把图标盖住一部分，视觉效果是“文字出现了但很丑”。TBSTYLE_LIST表示文字放在图标右侧并且水平排列；如果不加，工具栏默认按下按钮时会顺序绘制图标和文字，但图标尺寸受SetBitmap的图片尺寸约束，文字会覆盖在图标上。所以结论是：要做图文并排，必须同时设置TBSTYLE_TEXT和TBSTYLE_LIST。

样式设置时机也有关：必须在按钮创建之后、第一次显示之前设置，否则窗口已重绘再改样式不生效，或者只是闪了一下又变回去。我把这个问题列为“工具栏文字显示”头号坑。

// 开启文字显示的完整样式组合 m_wndToolBar.ModifyStyle(0, TBSTYLE_TEXT | TBSTYLE_LIST); // 为每个按钮设置文字内容 m_wndToolBar.SetButtonText(0, _T("新建")); m_wndToolBar.SetButtonText(1, _T("打开")); m_wndToolBar.SetButtonText(2, _T("保存")); // 设置文字与图标的间距，避免贴在一起 m_wndToolBar.SetInsertMarkColor(RGB(255, 0, 0)); // 无关，只是举例

逻辑说明：ModifyStyle第一个参数是需要清除的样式，第二个是要添加的样式。这里传 0 表示不清除任何原有样式。SetButtonText的索引和GetButtonInfo返回的索引一一对应，凡是SEPARATOR的按钮索引也占位，如果你在中间插入了分隔符，后续按钮的索引要跳过那个位置，否则文字会写错按钮。

参数说明：TBSTYLE_TEXT让按钮显示文字，TBSTYLE_LIST让文字在图标右侧水平排列。还有TBSTYLE_ALTDRAG、TBSTYLE_FLAT等，但图文显示相关的核心就是这两个。ModifyStyle是CWnd的通用方法，对于 Win32 工具栏来说它最终会向控件发送TB_SETSTYLE消息吗？实际上 MFC 的CToolBar::ModifyStyle在工具栏的派生类里被重写，内部会调用CToolBar::ChangeExStyle和CToolBar::SetButtonStructSize等，但最终影响样式的是TB_SETSTYLE。你不需要深究细节，只需知道必须在Create之后立刻设置。

3.2 设置文字并控制布局的代码示例

每个按钮文字的宽度自适应是最常见的需求。CToolBar 提供了一个GetButtonWidth和SetButtonWidth，但在图片和文字同时存在时，更建议让控件自己算：调用AutoSize()之后，它会根据按钮上的图标尺寸和文字字符串长度自动调整按钮宽度和工具栏整体宽度。

// 自动调整按钮尺寸以适应文字 void CMainFrame::RefreshToolBarText() { for (int i = 0; i < m_wndToolBar.GetCount(); i++) { CString strText; // 根据命令ID从资源表读取本地化文字 UINT nID = m_wndToolBar.GetItemID(i); if (nID == 0) continue; // 分隔符 BOOL bResult = strText.LoadString(nID); if (bResult) { m_wndToolBar.SetButtonText(i, strText); } } m_wndToolBar.AutoSize(); // 强制重排父窗口客户区，避免布局错乱 RecalcLayout(); }

逻辑说明：GetItemID返回按钮的命令 ID，如果返回 0 说明是分隔符。LoadString(nID)会从字符串表资源中读取对应 ID 的字符串。这种做法的好处是文字集中管理，切换语言时可以加载不同语言的字符串资源，而不用改代码。AutoSize是 CToolBar 的固有方法，它会重算每个按钮的宽高，但注意：工具栏的AutoSize不会自动调用父级的RecalcLayout，所以你还需要在函数最后通知控制条重新布局，否则可能出现工具栏尺寸变宽了但整个带状区域没有重绘的残留痕迹。

参数说明：GetCount返回按钮总数，包含分隔符。如果你在资源里定义了SEPARATOR，它的GetItemID返回 0，而空白位置也占一个索引，这个索引在SetButtonText时要跳过，否则后续按钮的文字全跑到前一个按钮上。强烈建议用ID_SEPARATOR常量代替裸的 0 判断，因为 MFC 内部确实用 0 表示分隔。

3.3 图片+文字水平排列与垂直排列的调整

有些界面希望文字在图片下方，像标准 Office 大按钮。CToolBar 本身不直接支持上下结构，但要实现并不难：把TBSTYLE_LIST去掉，仅保留TBSTYLE_TEXT，同时把按钮宽度设成固定值并把文字绘制成多行。但 MFC 自带的绘制逻辑不会做多行居中，文字会从左上角开始画。于是很多人开始踩“文字对不齐”的坑。

我的做法是放弃默认绘制，转而用NM_CUSTOMDRAW消息自己做部分绘制。先让工具栏使用标准风格，然后在OnTbCustomDraw里针对按钮文字绘制做调整：

// 在消息映射里添加 ON_NOTIFY(NM_CUSTOMDRAW, IDC_MY_TOOLBAR, &CMainFrame::OnTbCustomDraw) void CMainFrame::OnTbCustomDraw(NMHDR* pNMHDR, LRESULT* pResult) { LPNMTBCUSTOMDRAW lpTBCD = (LPNMTBCUSTOMDRAW)pNMHDR; if (lpTBCD->nmcd.dwDrawStage == CDDS_PREPAINT) { *pResult = CDRF_NOTIFYITEMDRAW; return; } if (lpTBCD->nmcd.dwDrawStage == CDDS_ITEMPREPAINT) { // 在这里可以重设文本颜色、背景色、以及处理上下布局 *pResult = CDRF_SKIPDEFAULT; // 或者 CDRF_NOTIFYPOSTPAINT 做二次绘制 } }

逻辑说明：NM_CUSTOMDRAW是通用控件自绘通知，工具栏也支持。上面的代码只是骨架，真正的垂直排列绘制要做成：先调用默认绘制画图标，再用DrawText在按钮下半部画文字，上半部留出图标空间。这种方法的优点是完全掌控布局，缺点是绘制代码和字体、颜色状态绑定，工作量大。更适合的方式是直接创建多个较小的按钮，用TBSTYLE_LIST+ 两行文字，或者干脆用CMFCToolBar（MFC 功能包提供的扩展工具栏），后者自带SetButtonText+CMFCToolBarButton的多行显示能力。不过本文主题限定在 CToolBar，所以我建议只针对个别需要上下排的大按钮做自绘，不要全局改。

这里补充一个判断标准：如果你只想让文字水平跟在图标右侧，用TBSTYLE_TEXT | TBSTYLE_LIST就足够，代码改动最小。如果你必须做上下结构，就用自绘，并且建议彻底弃用TBSTYLE_TEXT，自己全部画，否则文字由系统画、图标由你画，两套逻辑叠在一起容易出鬼影。

4. 自定义外观的高阶控制：样式、尺寸、状态与自绘

4.1 CToolBar 常用的样式位：TBSTYLE_ 家族与 CControlBar 的配合

CToolBar 虽然是 MFC 类，但底层是 Win32 工具栏控件，它支持一系列TBSTYLE_开头的样式。这些样式位决定了按钮的表现形式。我个人使用过的常用组合如下表，可以作为选型参考：

“样式位和 CControlBar 的配合”指的是CBRS_*系列成员函数，它们控制停靠、拉伸、边框等行为，但与TBSTYLE_没有直接冲突。你可以共存。例如CBRS_FLOAT_MULTI允许工具栏停靠时横向排列多个分段，而TBSTYLE_FLAT不影响这个行为。我见过有人把CBRS_SIZE_DYNAMIC误以为是“按钮大小可调”，其实它只是让工具栏可被用户拖拽时动态扩展宽度。

4.2 调整按钮大小和图片大小的入口：SetSizes 与 SetHeight

当你觉得按钮太拥挤或者图标模糊时，最容易想到的是改位图资源。但这有滞后性。运行时用代码调整更高效。SetSizes和SetHeight是两个不同层面的函数，经常被搞混：

// 设置按钮总尺寸（包括边框）和图片尺寸 m_wndToolBar.SetSizes(CSize(32, 32), CSize(20, 20)); // 单独设置控制条高度（仅影响工具栏整体高度，按钮按原尺寸居中） m_wndToolBar.SetHeight(40);

逻辑说明：SetSizes的第一个参数指定按钮矩形的宽高，第二个参数指定位图区域的宽高。图片会被拉伸或压缩到第二参数大小，按钮的可点击区域由第一参数控制。如果图片尺寸与按钮尺寸相差过大，图片会在按钮内按左上角对齐而不是居中，所以我用这个表格来统一参数：

SetHeight只是一个快捷方法，内部还是会调用SetSizes，只不过保持了图片原尺寸。如果你发现设置后按钮图片有偏移，优先检查是不是直接用了SetButtonInfo里的图片索引去对SetSizes产生的坐标，二者没有关系，但容易让人误以为设置顺序会影响居中。

需要强调：SetSizes必须在按钮创建之后调用，而且调用之前不要先SetBitmap，否则工具栏内部缓存的老尺寸会影响后续绘制。最稳妥的做法是在LoadToolBar或SetButtons之后、任何UpdateWindow之前调用。如果界面已经显示，再调用SetSizes可能会发生按钮重叠，需要紧跟Invalidate和UpdateWindow。

4.3 用 OwnerDraw 自绘实现任意效果的思路

当图标来源复杂或者要绘制动画状态时，标准按钮样式就不够用了。OwnerDraw 可以让按钮完全由你绘制，但 CToolBar 的 OwnerDraw 有个特别麻烦的地方：每个按钮都有TBBS_OWNERDRAW样式，绘制时系统通过WM_DRAWITEM消息把按钮矩形交给你。你需要在OnDrawItem中处理，而工具栏自身的背景和立体边框得你自己画。

void CMainFrame::OnDrawItem(int nIDCtl, LPDRAWITEMSTRUCT lpDrawItemStruct) { if (lpDrawItemStruct->CtlType == ODT_BUTTON) { // 从按钮自定义数据中获取原始 ID，区分不同按钮 WORD nCmdID = LOWORD(lpDrawItemStruct->CtlID); // 这里根据 nCmdID 绘制图标和文字 // 注意要处理 ODS_SELECTED 和 ODS_DISABLED 状态 } else { CFrameWnd::OnDrawItem(nIDCtl, lpDrawItemStruct); } }

逻辑说明：OnDrawItem是一个分散在多个窗口类里的回调，工具栏的 owner-draw 按钮会触发它。绘制过程中需要判断状态：lpDrawItemStruct->itemState里的ODS_SELECTED表示按下，ODS_DISABLED表示禁用。你还可以用ODS_CHECKED处理复选状态。按钮上如果既要有图标又要有文字，就把位图先绘制在矩形左侧，再计算文字矩形，用DrawText绘制文字并居中。

参数说明：nIDCtl是触发绘制子控件的资源 ID，但如果你在SetButtonInfo里设置的按钮 ID 是命令 ID，这里的CtlID可能不是命令 ID。更可靠的方式是在按钮创建时为每个按钮设置一个唯一的子 ID（例如从IDC_TOOLBAR_BTN_BEGIN递增），然后在SetButtonInfo里把命令 ID 设置成实际希望发送命令的那个 ID。绘制时用子 ID 区分，点击行为用命令 ID。这种拆分逻辑对自绘按钮很重要，因为工具栏最底层的按钮头里可以保存一组自有数据，MFC 的GetButtonInfo返回的则是被包装过的。

自绘的坑在于：Windows 工具栏自己会处理鼠标点击和焦点，如果你绘制逻辑没有适配按钮矩形偏移，点击时可能发生热点错位。我见过最诡异的情况是，按钮显示的地方和实际点击热区相差几个像素，就是因为自绘时画到了扩展的按钮矩形，但命中的是按钮的普通矩形。解决办法是把 DrawItem 得到的矩形和按钮本身的大小对齐，不要使用子类化后的坐标换算。

5. 工具栏自定义避坑指南：图片不显示、文字错位与高DPI的五个踩坑记录

5.1 图片总是灰色/空白：LoadBitmap 的 ID 类型不是 TOOLBAR

现象：用LoadToolBar加载一个 BITMAP 资源成功，但运行后工具栏按钮没有图片，按钮只是形状和状态栏文字。

原因：LoadToolBar只认TOOLBAR类型的资源。直接导入位图得到的资源类型是 BITMAP，MFC 的解析逻辑会读不到TOOLBAR头，于是按钮数组个数变成 0，工具栏只显示一个空框。

解决：在 VS 资源视图里为工具栏新建目录，选择“Toolbar”而不是“Bitmap”，然后把位图粘贴到 Toolbar 编辑器里。如果是从外部文明资源迁移，建议直接在.rc文件里手动新增TOOLBAR资源块，同时添加TOOLBAR的宏定义。也可以放弃资源方式，改用CImageList+SetButtons作为统一方案。我后来彻底改用后一种方式，彻底绕开资源类型问题。

5.2 文字显示成“烫烫烫”：字符串编码和按钮文本长度问题

现象：SetButtonText传入的字符串是正常的中文，按钮上显示却是乱码或类似“烫烫烫”的填充字符。

原因：中文在非 Unicode 的 MFC 工程里，CString默认是 ANSI 编码，但工具栏内部存储文本时可能按 Unicode 处理或反过来。尤其当资源文件编码和工程字符串编码不一致时，LoadString读出的字节流在转换为 TCHAR 数组时发生截断。SetButtonText底层调用TB_SETBUTTONINFO，其pszText指向的是内部缓冲，如果字符串超长或编码不匹配，就会读出内存里的未初始化区域，表现就是“烫烫烫”。

解决：确保工程使用 Unicode 字符集。在项目属性 -> 常规 -> 字符集里选“使用 Unicode 字符集”。然后所有字符串直接使用_T()宏包裹。如果必须使用 ANSI，需要调用MultiByteToWideChar转换后再传入。另外，不要把字符串直接写入按钮文本，而是从字符串表资源读取，由系统保证编码一致性。

5.3 按钮尺寸设置后图片居中不了：SetSizes 与位图尺寸不匹配

现象：调用SetSizes(CSize(32, 32), CSize(16, 16))后，按钮看起来宽了，但图片被挤在按钮左上角，右下区域空白。

原因：CToolBar 内部计算图片位置时，会根据SetSizes的第二参数设置图片矩形，但图片绘制位置默认是从按钮矩形的左上角偏移边框宽度开始。如果按钮边框较大，图片就不会居中。在 MFC 中SetSizes会同时设置按钮的边距和图片的绘制原点，但如果你此前直接SetBitmap而且位图宽度小于按钮宽度，图片会居左显示。

解决：不要让图片矩形小于可用区域太多。推荐的图片和按钮差值为 4-8 像素，比如 16 的图片配 22-24 的按钮。另外，SetSizes前先调用GetToolBarCtrl().SetButtonSize(CSize(w, h))，然后把图片尺寸设成相同的值或略小，最后再AutoSize。如果仍偏移，就自绘按钮并自己控制居中，这也是很多代工具条采用的绝对办法。

5.4 高DPI下图标模糊：缩放按钮尺寸却没换图标资源

现象：系统缩放 150% 时，工具栏按钮变大但图标边缘发虚，文字也有重影。

原因：CToolBar 不会自动切换位图资源。它在创建时按 DPI 感知的级别设置按钮尺寸，但位图是固定像素的，高 DPI 下只能做位图拉伸，当然模糊。文字则因为 GDI 字体未同步缩放，导致文字和图标尺寸不协调。

解决：在应用启动早期调用SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2)（针对 Win10 1703 以上），然后处理WM_DPICHANGED消息。在WM_DPICHANGED中重新创建工具栏的CImageList，从多个分辨率图标中选择一个，或者直接加载 SVG 转换成的 HICON。如果不想做多套图标，可以固定使用 20x20 或 24x24 的图标并关闭 DPI 缩放，但界面会发虚。更实用的是只保留 16、20、24 三套位图，通过编译常量或资源 ID 后缀切换。

5.5 热区混乱：在 CToolBar 里插入了其他控件导致坐标偏移

现象：工具栏上添加了组合框或按钮后，点击它右边的按钮时，实际响应的是左边的按钮。

原因：CToolBar 支持在按钮间嵌入子窗口，但当你用SetButtonInfo调整按钮顺序时，MFC 内部维护的按钮数组和子控件矩形没有同步更新。尤其是你使用了TBSTYLE_SEP而不是TBBS_SEPARATOR，分隔符的宽度设置不当，会压缩下一个按钮的热区坐标。

解决：在动态创建包含子控件的工具栏时，分隔符必须使用TBBS_SEPARATOR，并且通过SetButtonInfo设置其宽度为 0，然后在消息TBN_GETBUTTONINFO中指定子窗口的显示区域。更稳妥的方案是把子控件单独作为一个子窗口放在工具栏旁边，而不是嵌入按钮之间。如果必须嵌入，记住插入子控件后要重新AutoSize和RecalcLayout，而且不要再修改按钮索引，否则热点映射会全乱。

6. 进阶：无位图工具栏 + 系统图标列表 + 运行时换肤的一种干净做法

6.1 放弃位图，用系统图标列表生成按钮

如果你不想维护那一堆 BMP，可以换成直接使用系统图标资源，比如SHGetFileInfo或ImageList_LoadImage从 shell 提取图标。这在做文件管理类工具时尤其方便，按钮图标能直接反映文件类型。做法是先用SHGetFileInfo拿到 HICON，再Add进CImageList，后续逻辑和动态创建工具栏完全一样。关键是图标句柄的释放时机，SHGetFileInfo返回的图标在添加到 ImageList 后，ImageList 会复制图标内容而不持有原始句柄，所以你可以立刻DestroyIcon释放。如果忘了释放，每次创建工具栏都会泄漏 GDI 句柄，应用长时间运行后界面会逐渐渲染异常。我在某图像处理 Demo 里就是这样出现工具栏上图标随机消失的现象，排查了许久才发现是 GDI 泄漏。

// 从文件扩展名获得图标 SHFILEINFO shfi = { 0 }; if (::SHGetFileInfo(_T(".txt"), FILE_ATTRIBUTE_NORMAL, &shfi, sizeof(shfi), SHGFI_USEFILEATTRIBUTES | SHGFI_ICON | SHGFI_SMALLICON)) { m_imageList.Add(shfi.hIcon); ::DestroyIcon(shfi.hIcon); }

逻辑说明：SHGFI_USEFILEATTRIBUTES表示不访问实际文件，仅根据扩展名返回默认图标。SHGFI_SMALLICON取得 16x16 的图标。DestroyIcon要立刻释放，因为Add时我们已经拷贝了像素数据。这个方案可以让你省去制作所有按钮位图的繁琐工作，尤其是当按钮含义是“打开某种已在系统中注册的文件类型”时。

6.2 运行时切换图表集并保持文字不变

有些应用需要用户自己换主题，比如深色模式下图标要换成高对比度的。CToolBar 切换图标集并不难，难的是不要破坏已经配置好的文字。以下函数演示在运行时替换CImageList：

void CMainFrame::SetToolBarIconSet(UINT nIconResStart, int nCount) { // 创建新的图标列表 CImageList* pNewList = new CImageList; pNewList->Create(16, 16, ILC_COLOR32, nCount, 1); // 从连续的资源 ID 加载图标 for (int i = 0; i < nCount; i++) { HICON hIcon = (HICON)::LoadImage(AfxGetInstanceHandle(), MAKEINTRESOURCE(nIconResStart + i), IMAGE_ICON, 16, 16, LR_DEFAULTCOLOR); pNewList->Add(hIcon); ::DestroyIcon(hIcon); } // 替换工具栏当前图标列表 CImageList* pOldList = m_wndToolBar.GetImageList(); m_wndToolBar.SetImageList(pNewList); delete pOldList; // 小心：确认旧列表是动态分配的，不是成员变量 }

逻辑说明：SetImageList会更新按钮显示，但不会动按钮文字和命令 ID。所以你的文字、分隔符、状态全部保留。这里要重点注意旧列表的删除：如果旧列表是CImageList局部变量在Create时构造，现在它还活着，你直接delete就会内存错误。我习惯把工具栏的CImageList声明为CMainFrame的成员，切换时把新列表指针存到成员，旧列表则在新列表赋值后删除。还有一种做法是把列表指针存成std::unique_ptr，并用SetImageList的返回值配合Exchange，但 MFC 接口没有提供 swap，容易踩坑。因此我的规矩是：工具栏的图标列表要么是成员变量，要么通过new创建并且用delete释放，绝不传全局对象。

6.3 最后的一点收获

这些技巧积累到现在，我最大的感受是：CToolBar 的“自定义”并没有多高级，但每个细节之间互相牵连。资源类型、样式位、尺寸和 DPI 四件事如果有一件没同步，最后出来的工具栏就是有一种“说不出的别扭”。我通常会在界面框架初始化阶段就把这几项固定成一套统一函数，以后所有工具栏都复用，避免在多个窗口里重复调参。换图标、切换语言、调整高 DPI 都只改入口函数，而不是到处碰按钮索引。如果你也要做类似功能，建议从一套固定尺寸开始，先用动态方式跑通，再考虑资源方式。希望这篇内容能帮你少走我之前走过的弯路。

本文还有配套的精品资源，点击获取