简介CJ60lib 是一套面向 MFC 框架的经典界面库适合具备一定 C 与 Windows 编程基础、希望快速搭建专业桌面应用界面的开发者。它封装了对话框、工具栏、菜单、状态栏等常用组件并提供增强控件、布局管理、资源加载、消息映射扩展、托盘图标与日志调试等能力可减少重复造轮子的时间让开发者更专注于核心业务逻辑。资源包共 115 个文件约 149KB以 43 个 h 头文件与 41 个 cpp 源文件为主体另含 bmp、cur、ico 等界面位图与图标资源以及 dsp、dsw、clw 等工程与类向导文件便于直接编译研究。目前已有 192 人学习下载。通过阅读源码与示例读者可理解 MFC 界面库的组织方式、控件扩展思路与消息处理机制并将其集成到自己的项目中提升界面一致性与开发效率。1. CJ60lib 到底是什么一个被时间尘封的 MFC 界面增强库如果你在维护一套跑了十几年的 MFC 老系统客户突然要求界面“现代化一点”你大概会经历这样的心路重写不现实换 Qt 成本太高硬啃 MFC 自绘又太费时间。这时候有人提到 CJ60lib一个在 MFC 圈子里流传很久的界面库你搜了一圈发现资料零散、示例老旧、编译报错一堆于是陷入“这东西到底还能不能用”的犹豫。CJ60lib 本质上是一套基于 MFC 的界面增强类库核心解决的是原生 MFC 控件外观陈旧、缺乏现代交互反馈的问题。它提供了自绘菜单、工具栏、停靠面板、Outlook 风格导航栏、可换肤按钮等一整套控件封装让开发者不用从 WM_DRAWITEM 开始手写绘制逻辑就能把对话框和主框架窗口的视觉质感拉高一个档次。适合的人群很明确手上有一到多个 MFC 项目需要做界面改造但又不具备全面迁移到新框架条件的 C 桌面开发者。这篇文章不讲空泛的历史只讲怎么把它跑起来、怎么用对、以及哪些地方容易翻车。2. 把 CJ60lib 集成进 MFC 工程从编译到第一个自绘控件2.1 源码组织方式与工程配置选择CJ60lib 常见的分发形式是源码包里面通常包含若干 .h 和 .cpp 文件按功能模块划分比如菜单、工具栏、停靠窗口各成一组。拿到源码后第一件事不是急着往工程里加而是先判断你的项目类型是单文档、多文档还是基于对话框。不同类型的 MFC 工程CJ60lib 的初始化入口和消息链挂载点不一样搞错了就会出现控件不刷新或者点击无响应。我一般会先在解决方案里新建一个静态库工程把 CJ60lib 的源码全部加进去编译一遍。这样做的好处是隔离编译错误避免和主工程的预编译头、字符集设置互相干扰。编译通过后再把生成的 .lib 和头文件目录挂到主工程比直接把源码混进主工程要干净得多。如果你的项目是 Unicode 字符集需要确认源码里有没有硬编码的 ANSI 字符串有的话要么改工程字符集要么在包含头文件前做转换处理。2.2 最小集成步骤与初始化代码假设你已经把 CJ60lib 编译成了静态库接下来在主工程的 stdafx.h 或 pch.h 里包含核心头文件然后在应用程序类的 InitInstance 里做初始化。下面是一个最小可运行的集成片段// 在应用程序类的 InitInstance 中创建主窗口之前调用 #include CJ60Lib.h // 核心头文件具体名称以你拿到的源码为准 BOOL CMyApp::InitInstance() { // 初始化 CJ60lib 的内部状态必须在任何 CJ60 控件创建之前调用 // 参数传 NULL 表示使用默认资源句柄如果你的资源在独立 DLL 里需要另行指定 CJ60LibInitialize(NULL); CWinApp::InitInstance(); // 创建主框架窗口后续在窗口内使用 CJ60 控件 CMainFrame* pFrame new CMainFrame; m_pMainWnd pFrame; pFrame-LoadFrame(IDR_MAINFRAME); pFrame-ShowWindow(SW_SHOW); pFrame-UpdateWindow(); return TRUE; }这段代码的关键点在于初始化时机。CJ60LibInitialize 必须在任何 CJ60 控件对象构造之前执行否则控件内部会访问未初始化的全局状态表现为随机崩溃或者绘制出黑块。参数传 NULL 是常见做法表示使用当前进程的默认资源句柄如果你的界面资源放在单独的 MFC 扩展 DLL 里就需要把 DLL 的 HINSTANCE 传进去否则控件找不到位图、图标等资源。2.3 在对话框里替换标准控件为 CJ60 控件集成完成后下一步是把对话框上的标准 MFC 控件替换成 CJ60 对应控件。以按钮为例标准 CButton 换成 CJ60 的自绘按钮类通常做法是在对话框头文件里声明成员变量时改类型然后在 DoDataExchange 里绑定控件 ID。// 对话框头文件中把 CButton 替换为 CJ60 的按钮类 // 具体类名以源码为准这里用 CCJ60Button 代指 class CMyDlg : public CDialogEx { // ... 其他成员 CCJ60Button m_btnConfirm; // 替换原来的 CButton }; // DoDataExchange 中正常绑定 void CMyDlg::DoDataExchange(CDataExchange* pDX) { CDialogEx::DoDataExchange(pDX); DDX_Control(pDX, IDC_BTN_CONFIRM, m_btnConfirm); }替换之后按钮的外观会由 CJ60 库接管你可以在属性里设置按钮的普通、悬停、按下三种状态的位图或颜色。这里有个容易忽略的点如果你在资源编辑器里给按钮设置了 Owner Draw 属性需要去掉否则 CJ60 的自绘逻辑和 MFC 的 Owner Draw 机制会打架表现为按钮闪烁或者只绘制一半。另外批量替换控件时建议一个一个来替换一个编译运行一次确认没问题再换下一个一次性全换完出问题很难定位是哪个控件引起的。3. 自绘菜单与停靠面板CJ60lib 里最值得用的两个模块3.1 自绘菜单的挂载方式与消息映射CJ60lib 的自绘菜单模块是很多人用这个库的主要原因。原生 MFC 菜单在 Windows 高版本系统上虽然跟着系统主题走但样式单一没法做图标加文字混排、渐变背景、自定义高亮色这些效果。CJ60 的菜单类通过接管 WM_MEASUREITEM 和 WM_DRAWITEM 消息把菜单项的绘制完全接管过来。挂载方式通常是在主框架窗口的 OnCreate 里替换默认菜单int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct) { if (CFrameWnd::OnCreate(lpCreateStruct) -1) return -1; // 获取当前菜单并交给 CJ60 菜单类接管 // m_wndMenu 是 CJ60 菜单类的成员变量 CMenu* pMenu GetMenu(); if (pMenu ! NULL) { m_wndMenu.AttachMenu(pMenu-GetSafeHmenu()); // 设置菜单项的高亮颜色和文字颜色参数为 COLORREF m_wndMenu.SetHighlightColor(RGB(0, 120, 215)); m_wndMenu.SetTextColor(RGB(50, 50, 50)); } return 0; }AttachMenu 的作用是把标准 HMENU 交给 CJ60 菜单对象托管后续菜单的测量和绘制都会走 CJ60 的逻辑。SetHighlightColor 和 SetTextColor 是常用的两个外观参数前者控制鼠标悬停时的背景色后者控制菜单项文字颜色。需要注意的是如果你的菜单项里有动态添加或删除的项在修改菜单结构后要调用一次刷新方法否则新加的项可能还是按系统默认样式绘制。3.2 停靠面板的创建与布局参数CJ60lib 的停靠面板模块提供了类似 Visual Studio 那种可拖拽、可停靠、可自动隐藏的侧边栏。创建停靠面板一般分两步先创建面板对象再把它停靠到主框架的某个位置。// 在主框架的 OnCreate 中创建停靠面板 // m_wndDockLeft 是 CJ60 停靠面板类的成员变量 if (!m_wndDockLeft.Create(_T(属性面板), this, CRect(0, 0, 200, 400), TRUE, IDD_DOCK_LEFT)) { TRACE0(Failed to create dock pane\n); return -1; } // 设置面板允许停靠的位置左侧、右侧、浮动 m_wndDockLeft.EnableDocking(CBRS_ALIGN_LEFT | CBRS_ALIGN_RIGHT | CBRS_FLOAT_MULTI); // 把面板停靠到主框架左侧宽度 200 像素 EnableDocking(CBRS_ALIGN_ANY); DockControlBar(m_wndDockLeft, AFX_IDW_DOCKBAR_LEFT);Create 方法的参数依次是面板标题、父窗口、初始矩形、是否可见、面板内容的对话框资源 ID。EnableDocking 的参数决定这个面板能被拖到哪些位置CBRS_ALIGN_LEFT 和 CBRS_ALIGN_RIGHT 表示允许停靠左右两侧CBRS_FLOAT_MULTI 表示允许多个面板浮动在一起。DockControlBar 的第二个参数指定初始停靠位置AFX_IDW_DOCKBAR_LEFT 是 MFC 预定义的左侧停靠栏 ID。实际使用中面板内容的对话框资源需要设置成 Child 风格去掉标题栏和边框否则嵌进去之后会出现双层边框。面板的宽度可以在 Create 的矩形参数里指定但最终宽度会受停靠栏的布局影响如果发现宽度不对检查一下主框架有没有设置过大的最小宽度限制。3.3 工具栏与菜单的联动更新CJ60lib 的工具栏类支持在工具栏按钮上显示文字、下拉箭头、以及和菜单项联动的选中状态。联动更新的关键在于 ON_UPDATE_COMMAND_UI 消息的处理。当菜单项状态变化时工具栏按钮的状态需要同步刷新。// 在消息映射中声明更新处理函数 BEGIN_MESSAGE_MAP(CMainFrame, CFrameWnd) ON_UPDATE_COMMAND_UI(ID_VIEW_GRID, CMainFrame::OnUpdateViewGrid) END_MESSAGE_MAP() void CMainFrame::OnUpdateViewGrid(CCmdUI* pCmdUI) { // pCmdUI 同时关联菜单项和工具栏按钮 // 设置选中状态菜单项前面会出现勾选标记工具栏按钮会呈现按下状态 pCmdUI-SetCheck(m_bGridVisible ? 1 : 0); // 设置是否可用 pCmdUI-Enable(TRUE); }这段代码里 pCmdUI 是 MFC 的命令更新机制自动传入的它同时指向触发更新的菜单项和工具栏按钮。SetCheck 传 1 表示选中传 0 表示未选中。CJ60 的工具栏类会响应这个状态把按钮绘制成按下或弹起的样子。如果发现工具栏按钮状态没跟着菜单变先检查消息映射里有没有漏掉 ON_UPDATE_COMMAND_UI 条目再检查工具栏按钮的 ID 和菜单项 ID 是否一致。4. 避坑与排查CJ60lib 集成过程中最容易翻车的五个地方4.1 编译报错 “无法解析的外部符号”现象把 CJ60lib 源码加入工程后编译链接阶段报大量 LNK2019 错误提示某个 CJ60 类的成员函数无法解析。原因最常见的情况是源码文件没有全部加入编译或者静态库工程和主工程的运行库设置不一致。比如静态库用了 /MT主工程用了 /MD链接时就会找不到符号。另一个原因是某些 CJ60 源文件依赖 MFC 的特定版本宏如果你的工程定义的 _AFXDLL 和源码预期的不一样部分代码会被条件编译掉。解决先确认所有 .cpp 文件都参与了编译在解决方案资源管理器里检查每个文件的“从生成中排除”属性是否为“否”。然后统一运行库设置在项目属性 → C/C → 代码生成 → 运行库中确保静态库和主工程选同一项。最后检查 MFC 的使用方式在项目属性 → 常规 → MFC 的使用中确认是“在共享 DLL 中使用 MFC”还是“在静态库中使用 MFC”这个选项要和 CJ60lib 源码的预期一致。4.2 控件绘制出现黑块或闪烁现象CJ60 控件显示出来后背景是黑色或者拖动窗口时控件区域闪烁严重。原因黑块通常是因为控件的绘制消息没有被正确处理系统用默认背景刷填充了区域。闪烁则是因为没有开启双缓冲每次重绘都先擦背景再画内容。解决检查控件类有没有正确响应 WM_ERASEBKGND 消息CJ60 的控件一般会在这个消息里返回 TRUE 表示不擦背景。如果没有可以在控件类的消息映射里加上 ON_WM_ERASEBKGND处理函数直接返回 TRUE。对于闪烁确认 CJ60 控件是否支持双缓冲如果支持检查有没有调用开启双缓冲的方法如果不支持可以在父窗口的 OnEraseBkgnd 里做处理或者给控件加上 WS_CLIPCHILDREN 样式减少重绘区域。4.3 菜单项文字显示为乱码现象自绘菜单挂载后菜单项文字变成方块或乱码。原因字符集不匹配。CJ60lib 的早期版本很多是基于 ANSI 编写的内部用 char 处理字符串。如果你的工程是 Unicode 字符集直接把宽字符串传给 ANSI 接口就会乱码。解决先确认源码的字符集。如果源码是 ANSI 的而你的工程是 Unicode有两个选择一是把工程改成多字节字符集但这会影响工程里其他代码二是找到 CJ60 菜单类里处理文字的地方把 ANSI 接口替换成宽字符版本或者用 CString 的转换宏做中转。我一般倾向于后者虽然改动多一点但不用动整个工程的字符集设置。具体做法是在调用菜单文字设置方法前用 CT2W 或 CA2W 宏把字符串转成宽字符。4.4 停靠面板拖拽后布局错乱现象把停靠面板拖到新位置后面板大小异常或者和其他面板重叠。原因CJ60 的停靠面板在拖拽结束后会重新计算布局如果主框架的 RecalcLayout 没有被正确调用或者面板的最小尺寸、最大尺寸设置不合理就会出现布局错乱。解决在面板拖拽结束的消息处理里手动调用一次 RecalcLayout。另外检查面板的 SetMinSize 和 SetMaxSize 有没有设置如果最小尺寸设得比停靠栏还大拖拽后就会溢出。还有一个容易忽略的点是主框架的 EnableDocking 参数如果设成了 CBRS_ALIGN_ANY但实际只想让面板停靠在左右两侧拖到上下就会出问题建议按实际需求精确设置允许的停靠方向。4.5 程序退出时崩溃现象关闭主窗口后程序在退出过程中崩溃调试器指向 CJ60 的某个析构函数。原因CJ60 的全局状态在程序退出时被提前释放而某些控件对象还在析构中访问这些全局状态。常见于 CJ60LibInitialize 传了资源句柄但退出时没有对应的清理调用。解决在应用程序类的 ExitInstance 里调用 CJ60 库提供的清理函数确保全局状态在控件对象全部析构之后再释放。如果库没有提供清理函数检查一下是不是有全局的 CJ60 对象在静态存储区它们的析构顺序可能和 MFC 的清理顺序冲突。一个实用的做法是把 CJ60 的全局对象改成指针在 InitInstance 里 new在 ExitInstance 里 delete这样能精确控制生命周期。5. 让 CJ60lib 在现代 Windows 上跑得更稳的几个技巧5.1 高 DPI 下的缩放适配CJ60lib 诞生的时候高 DPI 显示器还不普及很多尺寸是写死的像素值。在 4K 屏上直接跑控件会小得看不清。我一般会在应用程序初始化时调用 SetProcessDPIAware 让进程感知 DPI然后在创建 CJ60 控件之前根据当前 DPI 缩放比例调整控件的尺寸参数。// 在 InitInstance 最开始调用让进程感知 DPI // 注意这个调用要在任何窗口创建之前 SetProcessDPIAware(); // 获取当前 DPI 缩放比例 HDC hdc GetDC(NULL); int dpiX GetDeviceCaps(hdc, LOGPIXELSX); ReleaseDC(NULL, hdc); float scale dpiX / 96.0f; // 96 是标准 DPI // 创建 CJ60 控件时把像素尺寸乘以 scale int nWidth static_castint(200 * scale); int nHeight static_castint(400 * scale);这段代码的关键是 SetProcessDPIAware 的调用时机必须在任何窗口创建之前否则不生效。scale 计算出来后所有传给 CJ60 控件的尺寸参数都要乘这个系数。字体大小也需要相应调整可以通过 CreateFont 指定高度时乘以 scale。如果发现缩放后控件位置偏移检查一下对话框资源的布局是不是用了固定坐标固定坐标在高 DPI 下不会自动缩放需要手动调整。5.2 用主题色统一管理外观CJ60lib 的各个控件外观是分散设置的按钮一个颜色、菜单一个颜色、停靠面板又一个颜色改起来很麻烦。我的习惯是定义一个全局的主题结构体把所有颜色集中管理初始化时统一应用到各个控件。// 定义主题颜色结构 struct CJ60Theme { COLORREF clrHighlight; // 高亮色 COLORREF clrText; // 文字色 COLORREF clrBackground; // 背景色 COLORREF clrBorder; // 边框色 }; // 全局主题实例 CJ60Theme g_theme { RGB(0, 120, 215), // 高亮色 RGB(50, 50, 50), // 文字色 RGB(245, 245, 245), // 背景色 RGB(200, 200, 200) // 边框色 }; // 在初始化时统一应用 void ApplyTheme() { m_wndMenu.SetHighlightColor(g_theme.clrHighlight); m_wndMenu.SetTextColor(g_theme.clrText); m_btnConfirm.SetHighlightColor(g_theme.clrHighlight); m_wndDockLeft.SetBackgroundColor(g_theme.clrBackground); // ... 其他控件 }这样做的价值在于当客户说“把蓝色换成绿色”的时候你只需要改 g_theme 里的一个值所有控件同步生效。如果后续要做多套皮肤切换也只需要准备多个 CJ60Theme 实例切换时重新调用 ApplyTheme 即可。注意有些 CJ60 控件的颜色设置方法名称可能不一样需要根据实际源码里的接口来调整但思路是一样的。5.3 用版本控制管理对 CJ60lib 的修改CJ60lib 的源码拿过来之后你大概率会改一些地方修 bug、适配字符集、调整默认参数。这些修改如果没有版本控制下次换一台机器或者重新拉一份源码改动就丢了。我的做法是把 CJ60lib 的源码单独放在一个仓库里主工程通过子模块或者包管理的方式引用。具体操作上我会在 CJ60lib 源码仓库里建一个 patches 目录把每一处修改做成独立的补丁文件补丁文件里写清楚修改原因和影响范围。主工程构建时先拉取原始源码再按顺序应用补丁。这样做的好处是升级 CJ60lib 版本时能清楚知道哪些改动需要重新适配而不是在一堆修改过的文件里大海捞针。5.4 一个验证集成是否成功的检查清单集成完成后跑一遍下面这个检查清单能提前发现大部分问题检查项预期结果失败时优先排查主窗口菜单显示菜单项有自绘高亮效果菜单挂载时机、字符集工具栏按钮悬停按钮有悬停变色工具栏类是否替换、消息映射停靠面板拖拽面板能停靠到指定位置EnableDocking 参数、RecalcLayout对话框按钮点击按钮响应正常且外观自绘控件类型替换、Owner Draw 属性程序退出无崩溃、无内存泄漏提示全局对象析构顺序、清理函数调用高 DPI 显示控件大小随 DPI 缩放SetProcessDPIAware 调用时机这个清单是我自己在多个 MFC 项目里集成 CJ60lib 之后总结出来的每次集成完跑一遍基本能覆盖八成以上的常见问题。清单里的检查项按优先级排列前面的不通过后面的不用急着测。5.5 什么时候该放弃 CJ60libCJ60lib 虽然能解决 MFC 界面老旧的燃眉之急但它也有明确的边界。如果你的项目需要支持触摸手势、需要做复杂的动画过渡、或者需要适配 Windows 11 的圆角和云母材质CJ60lib 是做不到的硬改的成本可能比重写界面还高。另一个判断标准是团队的技术栈如果团队里已经没有人熟悉 MFC 的消息机制和 GDI 绘制维护 CJ60lib 的定制修改会变成负担。我自己的习惯是在决定用 CJ60lib 之前先花半天时间做一个最小验证建一个空白的 MFC 对话框工程把 CJ60lib 集成进去替换一个按钮和一个菜单跑起来看看效果。如果半天内能跑通说明集成路径是通的后续投入可控如果半天还在跟编译错误较劲就要重新评估这个方向了。这个习惯帮我省过好几次后悔药希望也能帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/10 12:26:09 · 阅读 1.2k CJ60lib 实战：MFC 老系统界面现代化改造与避坑指南
简介CJ60lib 是一套面向 MFC 框架的经典界面库适合具备一定 C 与 Windows 编程基础、希望快速搭建专业桌面应用界面的开发者。它封装了对话框、工具栏、菜单、状态栏等常用组件并提供增强控件、布局管理、资源加载、消息映射扩展、托盘图标与日志调试等能力可减少重复造轮子的时间让开发者更专注于核心业务逻辑。资源包共 115 个文件约 149KB以 43 个 h 头文件与 41 个 cpp 源文件为主体另含 bmp、cur、ico 等界面位图与图标资源以及 dsp、dsw、clw 等工程与类向导文件便于直接编译研究。目前已有 192 人学习下载。通过阅读源码与示例读者可理解 MFC 界面库的组织方式、控件扩展思路与消息处理机制并将其集成到自己的项目中提升界面一致性与开发效率。1. CJ60lib 到底是什么一个被时间尘封的 MFC 界面增强库如果你在维护一套跑了十几年的 MFC 老系统客户突然要求界面“现代化一点”你大概会经历这样的心路重写不现实换 Qt 成本太高硬啃 MFC 自绘又太费时间。这时候有人提到 CJ60lib一个在 MFC 圈子里流传很久的界面库你搜了一圈发现资料零散、示例老旧、编译报错一堆于是陷入“这东西到底还能不能用”的犹豫。CJ60lib 本质上是一套基于 MFC 的界面增强类库核心解决的是原生 MFC 控件外观陈旧、缺乏现代交互反馈的问题。它提供了自绘菜单、工具栏、停靠面板、Outlook 风格导航栏、可换肤按钮等一整套控件封装让开发者不用从 WM_DRAWITEM 开始手写绘制逻辑就能把对话框和主框架窗口的视觉质感拉高一个档次。适合的人群很明确手上有一到多个 MFC 项目需要做界面改造但又不具备全面迁移到新框架条件的 C 桌面开发者。这篇文章不讲空泛的历史只讲怎么把它跑起来、怎么用对、以及哪些地方容易翻车。2. 把 CJ60lib 集成进 MFC 工程从编译到第一个自绘控件2.1 源码组织方式与工程配置选择CJ60lib 常见的分发形式是源码包里面通常包含若干 .h 和 .cpp 文件按功能模块划分比如菜单、工具栏、停靠窗口各成一组。拿到源码后第一件事不是急着往工程里加而是先判断你的项目类型是单文档、多文档还是基于对话框。不同类型的 MFC 工程CJ60lib 的初始化入口和消息链挂载点不一样搞错了就会出现控件不刷新或者点击无响应。我一般会先在解决方案里新建一个静态库工程把 CJ60lib 的源码全部加进去编译一遍。这样做的好处是隔离编译错误避免和主工程的预编译头、字符集设置互相干扰。编译通过后再把生成的 .lib 和头文件目录挂到主工程比直接把源码混进主工程要干净得多。如果你的项目是 Unicode 字符集需要确认源码里有没有硬编码的 ANSI 字符串有的话要么改工程字符集要么在包含头文件前做转换处理。2.2 最小集成步骤与初始化代码假设你已经把 CJ60lib 编译成了静态库接下来在主工程的 stdafx.h 或 pch.h 里包含核心头文件然后在应用程序类的 InitInstance 里做初始化。下面是一个最小可运行的集成片段// 在应用程序类的 InitInstance 中创建主窗口之前调用 #include CJ60Lib.h // 核心头文件具体名称以你拿到的源码为准 BOOL CMyApp::InitInstance() { // 初始化 CJ60lib 的内部状态必须在任何 CJ60 控件创建之前调用 // 参数传 NULL 表示使用默认资源句柄如果你的资源在独立 DLL 里需要另行指定 CJ60LibInitialize(NULL); CWinApp::InitInstance(); // 创建主框架窗口后续在窗口内使用 CJ60 控件 CMainFrame* pFrame new CMainFrame; m_pMainWnd pFrame; pFrame-LoadFrame(IDR_MAINFRAME); pFrame-ShowWindow(SW_SHOW); pFrame-UpdateWindow(); return TRUE; }这段代码的关键点在于初始化时机。CJ60LibInitialize 必须在任何 CJ60 控件对象构造之前执行否则控件内部会访问未初始化的全局状态表现为随机崩溃或者绘制出黑块。参数传 NULL 是常见做法表示使用当前进程的默认资源句柄如果你的界面资源放在单独的 MFC 扩展 DLL 里就需要把 DLL 的 HINSTANCE 传进去否则控件找不到位图、图标等资源。2.3 在对话框里替换标准控件为 CJ60 控件集成完成后下一步是把对话框上的标准 MFC 控件替换成 CJ60 对应控件。以按钮为例标准 CButton 换成 CJ60 的自绘按钮类通常做法是在对话框头文件里声明成员变量时改类型然后在 DoDataExchange 里绑定控件 ID。// 对话框头文件中把 CButton 替换为 CJ60 的按钮类 // 具体类名以源码为准这里用 CCJ60Button 代指 class CMyDlg : public CDialogEx { // ... 其他成员 CCJ60Button m_btnConfirm; // 替换原来的 CButton }; // DoDataExchange 中正常绑定 void CMyDlg::DoDataExchange(CDataExchange* pDX) { CDialogEx::DoDataExchange(pDX); DDX_Control(pDX, IDC_BTN_CONFIRM, m_btnConfirm); }替换之后按钮的外观会由 CJ60 库接管你可以在属性里设置按钮的普通、悬停、按下三种状态的位图或颜色。这里有个容易忽略的点如果你在资源编辑器里给按钮设置了 Owner Draw 属性需要去掉否则 CJ60 的自绘逻辑和 MFC 的 Owner Draw 机制会打架表现为按钮闪烁或者只绘制一半。另外批量替换控件时建议一个一个来替换一个编译运行一次确认没问题再换下一个一次性全换完出问题很难定位是哪个控件引起的。3. 自绘菜单与停靠面板CJ60lib 里最值得用的两个模块3.1 自绘菜单的挂载方式与消息映射CJ60lib 的自绘菜单模块是很多人用这个库的主要原因。原生 MFC 菜单在 Windows 高版本系统上虽然跟着系统主题走但样式单一没法做图标加文字混排、渐变背景、自定义高亮色这些效果。CJ60 的菜单类通过接管 WM_MEASUREITEM 和 WM_DRAWITEM 消息把菜单项的绘制完全接管过来。挂载方式通常是在主框架窗口的 OnCreate 里替换默认菜单int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct) { if (CFrameWnd::OnCreate(lpCreateStruct) -1) return -1; // 获取当前菜单并交给 CJ60 菜单类接管 // m_wndMenu 是 CJ60 菜单类的成员变量 CMenu* pMenu GetMenu(); if (pMenu ! NULL) { m_wndMenu.AttachMenu(pMenu-GetSafeHmenu()); // 设置菜单项的高亮颜色和文字颜色参数为 COLORREF m_wndMenu.SetHighlightColor(RGB(0, 120, 215)); m_wndMenu.SetTextColor(RGB(50, 50, 50)); } return 0; }AttachMenu 的作用是把标准 HMENU 交给 CJ60 菜单对象托管后续菜单的测量和绘制都会走 CJ60 的逻辑。SetHighlightColor 和 SetTextColor 是常用的两个外观参数前者控制鼠标悬停时的背景色后者控制菜单项文字颜色。需要注意的是如果你的菜单项里有动态添加或删除的项在修改菜单结构后要调用一次刷新方法否则新加的项可能还是按系统默认样式绘制。3.2 停靠面板的创建与布局参数CJ60lib 的停靠面板模块提供了类似 Visual Studio 那种可拖拽、可停靠、可自动隐藏的侧边栏。创建停靠面板一般分两步先创建面板对象再把它停靠到主框架的某个位置。// 在主框架的 OnCreate 中创建停靠面板 // m_wndDockLeft 是 CJ60 停靠面板类的成员变量 if (!m_wndDockLeft.Create(_T(属性面板), this, CRect(0, 0, 200, 400), TRUE, IDD_DOCK_LEFT)) { TRACE0(Failed to create dock pane\n); return -1; } // 设置面板允许停靠的位置左侧、右侧、浮动 m_wndDockLeft.EnableDocking(CBRS_ALIGN_LEFT | CBRS_ALIGN_RIGHT | CBRS_FLOAT_MULTI); // 把面板停靠到主框架左侧宽度 200 像素 EnableDocking(CBRS_ALIGN_ANY); DockControlBar(m_wndDockLeft, AFX_IDW_DOCKBAR_LEFT);Create 方法的参数依次是面板标题、父窗口、初始矩形、是否可见、面板内容的对话框资源 ID。EnableDocking 的参数决定这个面板能被拖到哪些位置CBRS_ALIGN_LEFT 和 CBRS_ALIGN_RIGHT 表示允许停靠左右两侧CBRS_FLOAT_MULTI 表示允许多个面板浮动在一起。DockControlBar 的第二个参数指定初始停靠位置AFX_IDW_DOCKBAR_LEFT 是 MFC 预定义的左侧停靠栏 ID。实际使用中面板内容的对话框资源需要设置成 Child 风格去掉标题栏和边框否则嵌进去之后会出现双层边框。面板的宽度可以在 Create 的矩形参数里指定但最终宽度会受停靠栏的布局影响如果发现宽度不对检查一下主框架有没有设置过大的最小宽度限制。3.3 工具栏与菜单的联动更新CJ60lib 的工具栏类支持在工具栏按钮上显示文字、下拉箭头、以及和菜单项联动的选中状态。联动更新的关键在于 ON_UPDATE_COMMAND_UI 消息的处理。当菜单项状态变化时工具栏按钮的状态需要同步刷新。// 在消息映射中声明更新处理函数 BEGIN_MESSAGE_MAP(CMainFrame, CFrameWnd) ON_UPDATE_COMMAND_UI(ID_VIEW_GRID, CMainFrame::OnUpdateViewGrid) END_MESSAGE_MAP() void CMainFrame::OnUpdateViewGrid(CCmdUI* pCmdUI) { // pCmdUI 同时关联菜单项和工具栏按钮 // 设置选中状态菜单项前面会出现勾选标记工具栏按钮会呈现按下状态 pCmdUI-SetCheck(m_bGridVisible ? 1 : 0); // 设置是否可用 pCmdUI-Enable(TRUE); }这段代码里 pCmdUI 是 MFC 的命令更新机制自动传入的它同时指向触发更新的菜单项和工具栏按钮。SetCheck 传 1 表示选中传 0 表示未选中。CJ60 的工具栏类会响应这个状态把按钮绘制成按下或弹起的样子。如果发现工具栏按钮状态没跟着菜单变先检查消息映射里有没有漏掉 ON_UPDATE_COMMAND_UI 条目再检查工具栏按钮的 ID 和菜单项 ID 是否一致。4. 避坑与排查CJ60lib 集成过程中最容易翻车的五个地方4.1 编译报错 “无法解析的外部符号”现象把 CJ60lib 源码加入工程后编译链接阶段报大量 LNK2019 错误提示某个 CJ60 类的成员函数无法解析。原因最常见的情况是源码文件没有全部加入编译或者静态库工程和主工程的运行库设置不一致。比如静态库用了 /MT主工程用了 /MD链接时就会找不到符号。另一个原因是某些 CJ60 源文件依赖 MFC 的特定版本宏如果你的工程定义的 _AFXDLL 和源码预期的不一样部分代码会被条件编译掉。解决先确认所有 .cpp 文件都参与了编译在解决方案资源管理器里检查每个文件的“从生成中排除”属性是否为“否”。然后统一运行库设置在项目属性 → C/C → 代码生成 → 运行库中确保静态库和主工程选同一项。最后检查 MFC 的使用方式在项目属性 → 常规 → MFC 的使用中确认是“在共享 DLL 中使用 MFC”还是“在静态库中使用 MFC”这个选项要和 CJ60lib 源码的预期一致。4.2 控件绘制出现黑块或闪烁现象CJ60 控件显示出来后背景是黑色或者拖动窗口时控件区域闪烁严重。原因黑块通常是因为控件的绘制消息没有被正确处理系统用默认背景刷填充了区域。闪烁则是因为没有开启双缓冲每次重绘都先擦背景再画内容。解决检查控件类有没有正确响应 WM_ERASEBKGND 消息CJ60 的控件一般会在这个消息里返回 TRUE 表示不擦背景。如果没有可以在控件类的消息映射里加上 ON_WM_ERASEBKGND处理函数直接返回 TRUE。对于闪烁确认 CJ60 控件是否支持双缓冲如果支持检查有没有调用开启双缓冲的方法如果不支持可以在父窗口的 OnEraseBkgnd 里做处理或者给控件加上 WS_CLIPCHILDREN 样式减少重绘区域。4.3 菜单项文字显示为乱码现象自绘菜单挂载后菜单项文字变成方块或乱码。原因字符集不匹配。CJ60lib 的早期版本很多是基于 ANSI 编写的内部用 char 处理字符串。如果你的工程是 Unicode 字符集直接把宽字符串传给 ANSI 接口就会乱码。解决先确认源码的字符集。如果源码是 ANSI 的而你的工程是 Unicode有两个选择一是把工程改成多字节字符集但这会影响工程里其他代码二是找到 CJ60 菜单类里处理文字的地方把 ANSI 接口替换成宽字符版本或者用 CString 的转换宏做中转。我一般倾向于后者虽然改动多一点但不用动整个工程的字符集设置。具体做法是在调用菜单文字设置方法前用 CT2W 或 CA2W 宏把字符串转成宽字符。4.4 停靠面板拖拽后布局错乱现象把停靠面板拖到新位置后面板大小异常或者和其他面板重叠。原因CJ60 的停靠面板在拖拽结束后会重新计算布局如果主框架的 RecalcLayout 没有被正确调用或者面板的最小尺寸、最大尺寸设置不合理就会出现布局错乱。解决在面板拖拽结束的消息处理里手动调用一次 RecalcLayout。另外检查面板的 SetMinSize 和 SetMaxSize 有没有设置如果最小尺寸设得比停靠栏还大拖拽后就会溢出。还有一个容易忽略的点是主框架的 EnableDocking 参数如果设成了 CBRS_ALIGN_ANY但实际只想让面板停靠在左右两侧拖到上下就会出问题建议按实际需求精确设置允许的停靠方向。4.5 程序退出时崩溃现象关闭主窗口后程序在退出过程中崩溃调试器指向 CJ60 的某个析构函数。原因CJ60 的全局状态在程序退出时被提前释放而某些控件对象还在析构中访问这些全局状态。常见于 CJ60LibInitialize 传了资源句柄但退出时没有对应的清理调用。解决在应用程序类的 ExitInstance 里调用 CJ60 库提供的清理函数确保全局状态在控件对象全部析构之后再释放。如果库没有提供清理函数检查一下是不是有全局的 CJ60 对象在静态存储区它们的析构顺序可能和 MFC 的清理顺序冲突。一个实用的做法是把 CJ60 的全局对象改成指针在 InitInstance 里 new在 ExitInstance 里 delete这样能精确控制生命周期。5. 让 CJ60lib 在现代 Windows 上跑得更稳的几个技巧5.1 高 DPI 下的缩放适配CJ60lib 诞生的时候高 DPI 显示器还不普及很多尺寸是写死的像素值。在 4K 屏上直接跑控件会小得看不清。我一般会在应用程序初始化时调用 SetProcessDPIAware 让进程感知 DPI然后在创建 CJ60 控件之前根据当前 DPI 缩放比例调整控件的尺寸参数。// 在 InitInstance 最开始调用让进程感知 DPI // 注意这个调用要在任何窗口创建之前 SetProcessDPIAware(); // 获取当前 DPI 缩放比例 HDC hdc GetDC(NULL); int dpiX GetDeviceCaps(hdc, LOGPIXELSX); ReleaseDC(NULL, hdc); float scale dpiX / 96.0f; // 96 是标准 DPI // 创建 CJ60 控件时把像素尺寸乘以 scale int nWidth static_castint(200 * scale); int nHeight static_castint(400 * scale);这段代码的关键是 SetProcessDPIAware 的调用时机必须在任何窗口创建之前否则不生效。scale 计算出来后所有传给 CJ60 控件的尺寸参数都要乘这个系数。字体大小也需要相应调整可以通过 CreateFont 指定高度时乘以 scale。如果发现缩放后控件位置偏移检查一下对话框资源的布局是不是用了固定坐标固定坐标在高 DPI 下不会自动缩放需要手动调整。5.2 用主题色统一管理外观CJ60lib 的各个控件外观是分散设置的按钮一个颜色、菜单一个颜色、停靠面板又一个颜色改起来很麻烦。我的习惯是定义一个全局的主题结构体把所有颜色集中管理初始化时统一应用到各个控件。// 定义主题颜色结构 struct CJ60Theme { COLORREF clrHighlight; // 高亮色 COLORREF clrText; // 文字色 COLORREF clrBackground; // 背景色 COLORREF clrBorder; // 边框色 }; // 全局主题实例 CJ60Theme g_theme { RGB(0, 120, 215), // 高亮色 RGB(50, 50, 50), // 文字色 RGB(245, 245, 245), // 背景色 RGB(200, 200, 200) // 边框色 }; // 在初始化时统一应用 void ApplyTheme() { m_wndMenu.SetHighlightColor(g_theme.clrHighlight); m_wndMenu.SetTextColor(g_theme.clrText); m_btnConfirm.SetHighlightColor(g_theme.clrHighlight); m_wndDockLeft.SetBackgroundColor(g_theme.clrBackground); // ... 其他控件 }这样做的价值在于当客户说“把蓝色换成绿色”的时候你只需要改 g_theme 里的一个值所有控件同步生效。如果后续要做多套皮肤切换也只需要准备多个 CJ60Theme 实例切换时重新调用 ApplyTheme 即可。注意有些 CJ60 控件的颜色设置方法名称可能不一样需要根据实际源码里的接口来调整但思路是一样的。5.3 用版本控制管理对 CJ60lib 的修改CJ60lib 的源码拿过来之后你大概率会改一些地方修 bug、适配字符集、调整默认参数。这些修改如果没有版本控制下次换一台机器或者重新拉一份源码改动就丢了。我的做法是把 CJ60lib 的源码单独放在一个仓库里主工程通过子模块或者包管理的方式引用。具体操作上我会在 CJ60lib 源码仓库里建一个 patches 目录把每一处修改做成独立的补丁文件补丁文件里写清楚修改原因和影响范围。主工程构建时先拉取原始源码再按顺序应用补丁。这样做的好处是升级 CJ60lib 版本时能清楚知道哪些改动需要重新适配而不是在一堆修改过的文件里大海捞针。5.4 一个验证集成是否成功的检查清单集成完成后跑一遍下面这个检查清单能提前发现大部分问题检查项预期结果失败时优先排查主窗口菜单显示菜单项有自绘高亮效果菜单挂载时机、字符集工具栏按钮悬停按钮有悬停变色工具栏类是否替换、消息映射停靠面板拖拽面板能停靠到指定位置EnableDocking 参数、RecalcLayout对话框按钮点击按钮响应正常且外观自绘控件类型替换、Owner Draw 属性程序退出无崩溃、无内存泄漏提示全局对象析构顺序、清理函数调用高 DPI 显示控件大小随 DPI 缩放SetProcessDPIAware 调用时机这个清单是我自己在多个 MFC 项目里集成 CJ60lib 之后总结出来的每次集成完跑一遍基本能覆盖八成以上的常见问题。清单里的检查项按优先级排列前面的不通过后面的不用急着测。5.5 什么时候该放弃 CJ60libCJ60lib 虽然能解决 MFC 界面老旧的燃眉之急但它也有明确的边界。如果你的项目需要支持触摸手势、需要做复杂的动画过渡、或者需要适配 Windows 11 的圆角和云母材质CJ60lib 是做不到的硬改的成本可能比重写界面还高。另一个判断标准是团队的技术栈如果团队里已经没有人熟悉 MFC 的消息机制和 GDI 绘制维护 CJ60lib 的定制修改会变成负担。我自己的习惯是在决定用 CJ60lib 之前先花半天时间做一个最小验证建一个空白的 MFC 对话框工程把 CJ60lib 集成进去替换一个按钮和一个菜单跑起来看看效果。如果半天内能跑通说明集成路径是通的后续投入可控如果半天还在跟编译错误较劲就要重新评估这个方向了。这个习惯帮我省过好几次后悔药希望也能帮到你。本文还有配套的精品资源点击获取