简介：这是MFC图形及界面编程的完整实例工程，面向初学Windows桌面应用开发的C++程序员，也适合需要系统梳理对话框机制的开发者。压缩包共54个文件，涵盖头文件、实现文件、工程配置、资源描述、编译中间文件以及可执行程序，包体约3.34MB，已有1657人浏览学习。内容围绕ShowDialog示例展开：从CDialog派生自定义对话框类，重写OnInitDialog完成控件初始化，通过DoModal显示模态窗口并在返回后处理用户指令，同时利用消息映射响应按钮点击事件。代码注释清晰、结构完整，可直接在Visual C++环境中打开运行，便于对照理解MFC应用框架的启动流程、控件访问方法和对话框生命周期管理。通过阅读整套源码，可以掌握基于MFC进行图形界面设计的基本套路，为进一步学习文档视图架构和自绘控件打下基础，适合作为课程设计或入门实战的参考蓝本。
1. MFC图形与界面编程实例：一份能直接编译运行的窗口程序素材库
接手一个年久失修的工控上位机项目时，面对满屏的CWnd、CDC、BEGIN_MESSAGE_MAP和一堆自定义消息宏，很多开发者第一反应是“这破代码还能跑吗”。没错，MFC虽然老，但它至今仍跑在大量工业控制、医疗设备和桌面工具软件里。这套MFC图形及界面编程实例包，就是把窗口创建、消息分发、GDI绘图、双缓冲动画、自绘控件和鼠标交互这些最常碰到的需求，拆成了一个个可独立编译的小工程，每个工程解决一个具体场景。适合三拨人：正在维护老MFC项目的开发者，想补一下C++原生窗口编程底子的新手，以及要在短时间内做出一个小工具界面又不想上重型框架的人。我建议把这份素材当成“API用法字典+可运行脚手架”来用，而不是当教程去背。
2. 工程骨架与消息机制：从CWinApp到消息映射的完整链路
2.1 工程结构与关键文件
打开这套实例包，每个子工程都是标准的单文档应用程序结构。一个常规MFC程序由五个关键部分组成：继承CWinApp的应用程序类、继承CFrameWnd的框架窗口类、继承CView的视图类、文档类和资源文件。视图类负责绘图，框架窗口类负责承载菜单、工具栏和状态栏，资源文件则保存了对话框、菜单、图标和字符串表。下面是典型的目录组织方式：
MFCGraphicDemo/ ├── MFCGraphicDemo.sln ├── MFCGraphicDemo/ │ ├── MFCGraphicDemo.h // CMyApp 应用程序类声明 │ ├── MFCGraphicDemo.cpp // 程序入口 InitInstance 实现 │ ├── MainFrm.h / MainFrm.cpp // 主框架窗口 CFrameWnd 派生类 │ ├── MFCGraphicDemoView.h // 视图类声明，绘图主战场 │ ├── MFCGraphicDemoView.cpp // OnDraw / OnPaint / 鼠标事件 │ ├── MFCGraphicDemoDoc.h // 文档类，保存绘图数据 │ ├── Resource.h // 资源ID宏定义 │ └── res/ // 图标、位图、工具栏图片每个文件职责分明，视图类负责和显示有关的全部逻辑，文档类只存数据。这套拆分在大型项目里能避免画图逻辑和数据逻辑互相纠缠。
应用程序类的InitInstance函数是程序的真正起点，它完成窗口创建和消息循环的启动。下面是实例包中最核心的一段：
BOOL CMyApp::InitInstance() { // 创建单文档模板：把框架窗口、文档类和视图类绑定在一起 CSingleDocTemplate* pDocTemplate; pDocTemplate = new CSingleDocTemplate( IDR_MAINFRAME, // 菜单和图标资源的 ID RUNTIME_CLASS(CMyDoc), // 文档类 RUNTIME_CLASS(CMainFrame), // 主框架窗口类 RUNTIME_CLASS(CMyView)); // 视图类 if (!pDocTemplate) return FALSE; AddDocTemplate(pDocTemplate); // 解析命令行使程序支持打开外部文件，实例包中直接忽略 CCommandLineInfo cmdInfo; ParseCommandLine(cmdInfo); // 派发命令并调度窗口的显示和更新 if (!ProcessShellCommand(cmdInfo)) return FALSE; m_pMainWnd->ShowWindow(SW_SHOW); m_pMainWnd->UpdateWindow(); return TRUE; }参数说明：CSingleDocTemplate的第一个参数IDR_MAINFRAME是资源标识，MFC会同时加载它关联的菜单、加速键表和文档图标；RUNTIME_CLASS宏让MFC在运行时动态创建对应类的对象，这是文档/视图架构能自动处理新建和打开文件的底层机制。
熟悉了这套启动链路，你就能理解为什么很多改需求的人会说“界面不是我画的，是框架帮我画的”——MFC的导演是应用程序类，演员是框架窗口和视图类，资源文件是剧本。
2.2 消息映射与事件分发
MFC程序里没有像C#那样显式的event关键字，事件绑定靠的是消息映射表。这套宏机制本质上是一张函数指针查表，把Windows消息编号和成员函数一一对应。实例包里有一段很典型的视图类消息映射代码：
BEGIN_MESSAGE_MAP(CMyView, CView) // 标准窗口消息 ON_WM_LBUTTONDOWN() // 鼠标左键按下 ON_WM_LBUTTONUP() // 鼠标左键释放 ON_WM_MOUSEMOVE() // 鼠标移动 ON_WM_ERASEBKGND() // 背景擦除事件，与防闪烁有关 // 自定义命令消息 ON_COMMAND(ID_DRAW_LINE, &CMyView::OnDrawLine) ON_COMMAND(ID_DRAW_RECT, &CMyView::OnDrawRect) ON_COMMAND(ID_COLOR_RED, &CMyView::OnColorRed) END_MESSAGE_MAP()这条消息链路从操作系统到你的代码要经过三层：Windows把鼠标事件放进程序的消息队列，CWinApp的Run函数通过GetMessage取出消息并派发，最后由消息映射表匹配到具体处理函数。ON_WM_LBUTTONDOWN这类宏实际展开成了一个静态的AFX_MSGMAP结构体，里面保存了消息编号、消息处理函数地址和中断标记。
踩过一个实际的坑：在对话框里如果忘记调用CDialog::OnInitDialog的基类版本，对话框就收不到初始化完成后的第一条WM_INITDIALOG，导致某些控件初始状态不对。所以当你自定义消息映射时，务必保证自己实现的函数签名和宏所对应的签名完全一致，参数列表对不上程序会在编译期报错，但运行期不提示任何信息。
2.3 资源文件与控件关联
MFC界面风格之所以统一，是因为菜单、工具栏按钮、对话框模板全部由.rc资源文件定义。资源ID在Resource.h中声明，IDE通过资源编辑器维护。实例包里几乎所有对话框相关工程都用DoDataExchange把控件和成员变量绑定，这是MFC界面程序里绕不开的“后悔药”机制——不需要手动写GetDlgItem获取窗口句柄，框架自动完成控件与变量的双向同步：
void CMyDialog::DoDataExchange(CDataExchange* pDX) { CDialogEx::DoDataExchange(pDX); // 编辑框绑定到 CString 变量 DDX_Text(pDX, IDC_EDIT_NAME, m_strName); // 复选框绑定到 BOOL 变量 DDX_Check(pDX, IDC_CHECK_SAVE, m_bSaveFlag); // 滑块绑定到 int 变量，并限定范围 DDX_Slider(pDX, IDC_SLIDER_WIDTH, m_nPenWidth); DDV_MinMaxInt(pDX, m_nPenWidth, 1, 20); }DDX_Text负责把IDC_EDIT_NAME控件里的文本读到m_strName，方向则由UpdateData(TRUE)或UpdateData(FALSE)控制。TRUE表示从控件读数据到变量，FALSE表示从变量刷到控件。DDV_MinMaxInt是校验宏，变量越界会弹出提示框。
这种绑定把手工GetWindowText和SetWindowText的样板代码省掉了。不过要注意：DoDataExchange只在窗口创建和调用UpdateData时触发，如果你在运行时动态改了控件内容，别指望变量自动跟着变，必须先调UpdateData(TRUE)再读变量。
3. 核心绘图模块拆解：GDI绘图、双缓冲与鼠标交互
3.1 GDI绘图基础与坐标体系
MFC的绘图全部走GDI（图形设备接口），所有画线、填充、文字输出都发生在视图类的OnDraw或OnPaint函数里。先说坐标系：客户区原点在窗口左上角，x轴向右为正，y轴向下为正，单位是像素。很多新手在绘制柱状图时习惯用数学坐标系，结果画出来的图形是倒的，这就是没有做y轴翻转。
实例包里的基础绘图工程给出了一个很规整的OnDraw实现：
void CMyView::OnDraw(CDC* pDC) { // 获取客户区矩形 CRect rcClient; GetClientRect(&rcClient); // 创建蓝色画笔，2像素宽 CPen pen(PS_SOLID, 2, RGB(0, 0, 255)); CPen* pOldPen = pDC->SelectObject(&pen); // 画一条从左上角指向右下角的对角线 pDC->MoveTo(0, 0); pDC->LineTo(rcClient.Width(), rcClient.Height()); // 画一个空心矩形，用当前画笔绘制边界 pDC->Rectangle(50, 50, 200, 150); // 画一个实心椭圆，用当前画刷填充内部 CBrush brush(RGB(255, 0, 0)); CBrush* pOldBrush = pDC->SelectObject(&brush); pDC->Ellipse(220, 60, 380, 160); // 恢复旧的GDI对象，避免影响后续绘制 pDC->SelectObject(pOldPen); pDC->SelectObject(pOldBrush); }逻辑说明：MoveTo和LineTo构成一条独立线段，Rectangle的前两个参数是左上角坐标，后两个是右下角坐标，Ellipse参数同理但画的是内切椭圆。SelectObject把画笔或画刷选入设备上下文，返回旧对象指针，这一步必不可少。
参数说明：PS_SOLID表示实线画笔；RGB宏三个参数分别是红、绿、蓝分量，取值0到255。画笔和画刷创建后用完要DeleteObject，但在SelectObject恢复旧对象后，MFC的析构函数会自动处理局部对象，你只需要手动管理堆上创建的GDI对象。
这个工程的画图逻辑都在OnDraw里，窗口最小化再恢复时，系统发WM_PAINT消息自动重绘，你不需要额外保存绘制结果。这就是所谓“存数据，不存像素”的MFC思维：绘图代码随时可以重新执行，数据才是唯一真相。
3.2 双缓冲动画避免闪烁
凡是用MFC做过动态绘图的人都经历过那个经典问题：窗口里画动画，画面疯狂闪烁。闪烁的根源是系统默认先擦除背景（用白色填充客户区），再调用绘图代码重画，这一擦一画之间人眼就看到了空窗期。
双缓冲是治标又治本的手段，这套实例包里的动画工程完整展示了这个技术。核心思路是先在内存中创建一块和客户区一样大的画布，所有绘制操作都在内存画布上执行，绘制完成后一次性把整块画布拷贝到屏幕。代码长这样：
void CMyView::OnPaint() { CPaintDC dc(this); // 设备上下文，关联窗口客户区 CRect rc; GetClientRect(&rc); // 第一步：创建内存兼容DC和位图 CDC memDC; memDC.CreateCompatibleDC(&dc); CBitmap memBitmap; memBitmap.CreateCompatibleBitmap(&dc, rc.Width(), rc.Height()); CBitmap* pOldBmp = memDC.SelectObject(&memBitmap); // 第二步：先用白色填充内存画布，避免透明底噪 memDC.FillSolidRect(rc, RGB(255, 255, 255)); // 第三步：在内存DC上进行实际绘制 DrawGraph(&memDC); // 第四步：一次性将内存画布整体拷贝到窗口 dc.BitBlt(0, 0, rc.Width(), rc.Height(), &memDC, 0, 0, SRCCOPY); // 第五步：恢复并释放资源 memDC.SelectObject(pOldBmp); }逻辑说明：CreateCompatibleDC创建的内存DC和窗口DC共用同一套颜色格式，这样BitBlt按位拷贝时不会发生格式转换，速度最快。CreateCompatibleBitmap创建同尺寸位图，SelectObject把它挂到内存DC上作为画布。
参数说明：BitBlt的五个关键参数是目标x、y、宽度、高度、源DC、源x、y和光栅操作码SRCCOPY（直接覆盖，不做透明处理）。如果画的是带背景的控件，可以把SRCCOPY换成SRCAND等操作码实现透明效果，但实例包里没这么做，普通场景不需要。
配套的做法是重载OnEraseBkgnd并直接返回TRUE，让系统跳过擦背景这步，进一步减少闪烁。双缓冲的代价是多占一块和窗口同尺寸的内存，在4K屏下大约是几十兆，但在现代机器上完全可接受。
3.3 鼠标交互与橡皮筋画图
纯静态绘图没有太多实用价值，实例包里有一个“鼠标画图”工程，实现了一套完整的橡皮筋交互：鼠标按下时确定起点，拖动时画一条跟随鼠标移动的预览线段，松手时固定这条线段。这种交互模式是各类绘图软件的基础。
实现拆成三步，用成员变量保存中间状态：
// 在视图类头文件里保存鼠标状态 BOOL m_bDrawing; // 是否正在绘制 CPoint m_ptStart; // 起点坐标 CPoint m_ptEnd; // 当前鼠标坐标 void CMyView::OnLButtonDown(UINT nFlags, CPoint point) { m_bDrawing = TRUE; // 进入绘制状态 m_ptStart = point; // 记录起点 m_ptEnd = point; // 终点暂时等于起点 SetCapture(); // 捕获鼠标，保证拖动过程中窗口外也能收到消息 CView::OnLButtonDown(nFlags, point); } void CMyView::OnMouseMove(UINT nFlags, CPoint point) { if (m_bDrawing) { // 先“擦掉”上一次的预览线段 CClientDC dc(this); dc.SetROP2(R2_NOT); // 设置反色绘图模式 dc.MoveTo(m_ptStart); dc.LineTo(m_ptEnd); // 用反色重画旧线段，实现擦除 // 再以当前位置画新的预览线段 m_ptEnd = point; dc.MoveTo(m_ptStart); dc.LineTo(m_ptEnd); } CView::OnMouseMove(nFlags, point); } void CMyView::OnLButtonUp(UINT nFlags, CPoint point) { if (m_bDrawing) { m_bDrawing = FALSE; m_ptEnd = point; ReleaseCapture(); // 释放鼠标捕获 // 把这条线段保存到文档数据里，OnDraw统一重绘 CMyDoc* pDoc = GetDocument(); pDoc->AddLine(m_ptStart, m_ptEnd); Invalidate(FALSE); // 让视图区整体重绘 } CView::OnLButtonUp(nFlags, point); }这段代码的核心技巧是SetROP2(R2_NOT)反色模式。第一次用反色画线段，屏幕上出现线段；第二次用反色画同一条线段，像素会恢复原状，视觉上就像把线擦掉了。这么做省去了维护背景位图的麻烦，代价是连续多次OnMouseMove会反复擦画，CPU开销略高，但对常规场景完全够用。
Invalidate(FALSE)参数很关键，FALSE表示不擦除背景，配合OnDraw里直接把已确认图形重画一遍，就没有闪烁问题。如果你传TRUE，系统会先填白画面再重绘，刚才压下去的闪烁问题又回来了。
这套交互模式能平滑地扩展到矩形、椭圆和任意多边形，改的地方只有绘制函数本身。
4. 常见问题排查：编码崩溃、GDI泄漏与闪烁翻车的避坑记录
4.1 Unicode字符集不匹配导致的编译报错
现象：工程在Visual Studio中编译时报error C2664，说无法将“const char *”转换为“LPCWSTR”，或者直接提示找不到某个库函数的重载版本。网上搜索发现很多人说“换用宽字符”解决，但自己改了还是一堆错。
原因：Visual Studio新建MFC工程默认使用Unicode字符集，代码里的字符串字面量默认是窄字符（char*），而MFC的CString在Unicode模式下内部存储的是宽字符（wchar_t*），直接把窄字符串塞进去当然不匹配。很多老教材里的代码基于多字节字符集，抄过来就翻车。
解决：项目属性 → 常规 → 字符集，改成“使用多字节字符集”，这种改法让源码兼容性最好，但其实最推荐的是一劳永逸用_T宏包住所有字符串字面量，例如_T("hello")。T宏在Unicode模式下展开为L"hello"，多字节模式下展开为"hello"。从那以后我每次写MFC字符串都强制走一遍_T宏。
4.2 GDI对象泄漏导致绘图异常
现象：程序运行几分钟后发现绘制速度变慢，线条断裂，任务管理器能看到GDI对象数量持续增长不回落。严重时新窗口创建失败，整个程序白屏。
原因：最常见的是在循环里创建画笔、画刷、字体或兼容DC时没有DeleteObject。GDI对象是系统级资源，一个进程默认上限是1万个，用完不释放就一直在那占坑。CPen、CBrush这种栈对象析构时能自动释放，但如果你用了new创建或者在OnDraw里频繁CreateCompatibleDC并忘记DeleteDC，就会泄漏。
解决：养成两个习惯。第一，局部GDI对象用完立即恢复旧对象并DeleteObject：
CPen* pPen = new CPen(PS_DASH, 1, RGB(0, 0, 0)); CDC* pDC = GetDC(); CPen* pOld = pDC->SelectObject(pPen); // 绘制操作 pDC->SelectObject(pOld); pPen->DeleteObject(); // 手动删除堆上创建的GDI对象第二，可以用任务管理器直接到“性能”标签页看GDI对象列确认泄漏源，再用排除法注释掉可疑绘制代码。实例包里的工程都严格遵守了先SelectObject恢复、再DeleteObject的顺序，照抄不会踩坑。
4.3 窗口缩放时画面闪烁
现象：拖动窗口边框改变大小时，视图区出现明显的白闪或残影，尤其是内容复杂的图形显示区。
原因：MFC在窗口尺寸变化时先发送WM_ERASEBKGND消息，默认处理是填充白色背景，然后再发WM_PAINT重绘。一擦一画之间，屏幕经历了“有内容 → 空白 → 有内容”的转变，闪烁感就来了。
解决：在视图类重载OnEraseBkgnd，直接返回TRUE阻止背景被擦除：
BOOL CMyView::OnEraseBkgnd(CDC* pDC) { // 返回TRUE表示背景已处理，系统不再填充白色 return TRUE; }同时把绘制逻辑移入双缓冲流程。这个组合拳打完之后，窗口缩放就不会再有闪烁。注意：OnEraseBkgnd返回TRUE后，原本的绘图函数里不要依赖DC已被清空，必须自己在OnDraw或内存画布上FillSolidRect打底。
4.4 高分屏下控件模糊和错位
现象：程序在Surface或高分辨率笔记本上运行，界面模糊，按钮文字发虚，对话框整体比预期小一圈。
原因：系统默认对没有适配DPI的程序做位图拉伸，实现“兼容”显示，代价就是画面模糊。MFC这个年代的项目普遍没有写入DPI感知声明。
解决：在程序入口调用SetProcessDPIAware让系统放弃拉伸：
BOOL CMyApp::InitInstance() { // 启用DPI感知，控件尺寸不再被系统缩放 SetProcessDPIAware(); // 其他初始化逻辑 }也可以直接在清单文件里声明dpiAware为true。实例包里提供了两种方式：老项目用API调用，新工程用manifest声明。改完后程序在高分屏下的清晰度恢复正常，但要重新核对对话框控件的布局尺寸，因为像素密度变了，部分按钮可能被截断。
5. 二次开发改造：把实例模块改造成你自己的简易画图工具
拿到这套实例包，最直接的二次开发路线是把“鼠标画图”工程扩展成一个带编辑功能的小画板。我一般会按这样的顺序改造：先加菜单项，再绑定命令处理函数，最后补齐状态存储。
第一步，在Resource.h里声明新菜单ID，然后在资源编辑器的菜单里加上“颜色选择”和“线宽调整”两个菜单项。第二步，在视图类里添加命令处理函数，弹出一个选择颜色的标准对话框：
void CMyView::OnColorPick() { // 初始化当前颜色为黑色 CColorDialog dlg(m_crPenColor); if (dlg.DoModal() == IDOK) { // 取用户选中的颜色 m_crPenColor = dlg.GetColor(); } }第三步，把OnDraw里的画笔创建改用m_crPenColor，同时新增一个保存线宽的成员变量，并在绘制线段时动态创建对应宽度的画笔：
void CMyView::OnDraw(CDC* pDC) { CPen pen(PS_SOLID, m_nPenWidth, m_crPenColor); CPen* pOld = pDC->SelectObject(&pen); // 遍历文档里的线段数据并绘制 pDC->SelectObject(pOld); }参数说明：m_nPenWidth是用户通过滑块设置的线宽，范围限定在1到20，用DDV_MinMaxInt校验。m_crPenColor默认传黑色。这样改造后，原来的静态绘图就升级成了可用鼠标选色、调线宽、画直线的工具。
验证方式很简单：编译运行，画几条线，切颜色再画，然后最小化窗口再恢复，确认图形还在。图形之所以能在重绘后出现，正是因为所有图形数据都存在文档类的CArray容器里，OnDraw每次根据数据重建画面。这也是MFC文档/视图架构真正闪光的地方——你不必在OnPaint里逐段重放操作，只需要维护好数据模型。
最后补一句：如果你要把这些实例代码搬进一个真实项目，记得改掉工程名和资源ID前缀，避免和现有项目冲突。希望这套素材能帮你把MFC那块黑匣子打开，让你在维护老项目时少走几步弯路。
本文还有配套的精品资源，点击获取
