简介一套基于Visual C 2008编写的MFC单文档界面SDI多视图切换示例工程面向需要掌握MFC视图管理机制的Windows桌面开发者尤其适合正在学习文档/视图架构或希望实现文本、表单、图形等视图动态切换的读者。压缩包内含完整可编译的SDIMultiView工程共23个文件按功能划分为8个头文件、6个C源文件、2个图标文件以及资源脚本、项目配置和辅助说明文档等主体代码体量很小整包仅138KB便于快速阅读与改造。已有1299人浏览学习。工程演示了创建CView派生视图类、注册运行时类、通过CDocTemplate管理多视图以及利用AddView/RemoveView和SetActiveView完成切换的完整流程对视图生命周期、布局调整和数据同步等关键细节也给出了可运行的参考写法。通过这份源码可以直观理解MFC中一个文档对应多个视图的协作方式快速迁移到自己的SDI项目里。 做单文档应用做到后面十有八九会遇到这么个需求同一个框架窗口里今天要显示表格明天要换成图表后天又想整个实时渲染的OpenGL窗口进去而且不能让用户觉得他在开多个程序得在同一个窗口里利索地切来切去。MFC单文档视图结构默认是一对一的文档视图绑定框架窗口里固定挂一个视图想多几种模样就得在切换上做文章。这篇文章就聊清楚一件事在MFC单文档里做多视图切换方案怎么选、代码怎么写、坑怎么避。内容包括四种主流实现方式的对比、动态替换视图的完整代码、一个带列表视图又带OpenGL渲染视图的实战示例以及我实际调试中遇到的各种报错和排查思路。适合正在做MFC桌面工具或者准备拿MFC做上位机、编辑器、可视化小工具的朋友看完可以直接上手改自己的工程。1. 先把思路理清楚单文档下做视图切换本质上就四种路数1.1 为什么默认的文档视图结构不够用MFC单文档应用启动的时候框架窗口里面只有一个视图实例这个视图是CDocTemplate创建出来的和文档对象、框架窗口三者是绑在一起的关系。默认情况下CFrameWnd的客户区被这个唯一的视图填满。你想切到另一个不同类型的视图别指望框架自己能帮你——它连换视图这件事的接口都没暴露。我在早期刚接触这个问题时试过简单粗暴的做法把旧的视图指针DestroyWindow再动态new一个新视图Create。结果呢要么崩溃要么文档指针丢要么工具栏和状态栏布局错乱。后来才意识到MFC的视图切换不是换个控件那么单纯它牵扯到视图与文档的关联、框架窗口的布局重算、视图初始化时机还有焦点、消息路由这一整套机制。所以先说结论视图切换有四种主流方案不是每种都适合你的场景。1.2 四种方案的特点对比与选型建议方案核心思路适用场景坑点动态替换视图在框架窗口内销毁旧视图、创建并激活新视图同一文档在不同展示形态间切换注意视图创建上下文、布局重算多文档模板每个视图配独立Document和DocTemplate各视图数据模型差异大、逻辑独立模板注册繁琐、文档数据共享麻烦分割窗口用CSplitterWnd把客户区拆成多个窗格各放不同视图需要同时对比两种视图每个窗格较窄不适合单一视图密集操作Tab页式视图用Tab Control挂载多个子视图点击标签切换工具型软件、多面页设置类界面消息路由要手动转视图创建时机要把握好我在实际项目中用得最多的是第一种“动态替换”因为它最接近用户感知里的“同一个窗口换界面”而且实现成本相对低不需要动文档模板。第二种适合视图各自带着完全不同的数据结构第三种是“同时看”不是“切换”第四种体验最好但封装逻辑多一点。后面我重点拆第一种然后把第四种做一个变种玩法放到第三个章节的实战里一起讲正好可以和列表视图、OpenGL渲染混着用。2. 核心实现动态替换CView的完整方法与代码2.1 先理解视图创建的底层参数动态替换视图本质就是手动执行“框架窗口在启动时会帮你做的事”。框架创建视图时有几个关键参数视图的CRuntimeClass、CCreateContext上下文、窗口样式、视图ID。CCreateContext尤其关键它是MFC文档视图关联的“媒人”里面存了m_pCurrentDoc、m_pNewDocTemplate、m_pCurrentFrame这些指针。如果你创建新视图时这个上下文是空的新视图就不知道自己的文档是谁后面GetDocument()会返回空指针程序基本抬走。窗口样式方面要注意视图的窗口样式必须是WS_CHILD否则它不会被正确嵌入到框架客户区。视图ID在单文档里一般用AFX_IDW_PANE_FIRST表示这是主客户区窗格用其他ID会导致资源管理器和工具栏的布局计算错位。2.2 SwitchView函数的完整实现下面是我一直在用的切换函数放在CMainFrame里参数接收目标视图的运行时类这样想切到哪个视图就往里传哪个类函数的通用性很强。void CMainFrame::SwitchView(CRuntimeClass* pNewViewClass, CCreateContext* pContext) { // 如果当前活动视图已经是目标类型就不做重复切换 CView* pCurrentView GetActiveView(); if (pCurrentView pCurrentView-IsKindOf(pNewViewClass)) return; // 保存当前视图指针这个指针不能直接销毁因为文档可能还挂着他 CView* pOldView pCurrentView; // 检查新视图是否已经存在。这一步很多人忽略导致切换多次后内存里堆了一大堆视图对象 HWND hNewWnd ::GetWindow(GetSafeHwnd(), GW_CHILD); CView* pNewView NULL; while (hNewWnd) { CView* pView DYNAMIC_DOWNCAST(CView, CWnd::FromHandlePermanent(hNewWnd)); if (pView pView-IsKindOf(pNewViewClass)) { pNewView pView; break; } hNewWnd ::GetWindow(hNewWnd, GW_HWNDNEXT); } // 新视图不存在就创建它 if (pNewView NULL pContext) { pNewView (CView*)pNewViewClass-CreateObject(); if (!pNewView) return; CRect rect; GetClientRect(rect); // 样式必须是WS_CHILDID必须是AFX_IDW_PANE_FIRST pNewView-Create(NULL, NULL, WS_CHILD | WS_VISIBLE | WS_BORDER, rect, this, AFX_IDW_PANE_FIRST, pContext); pNewView-OnInitialUpdate(); } // 切换到新视图 if (pNewView) { SetActiveView(pNewView); pNewView-ShowWindow(SW_SHOW); pNewView-Invalidate(); // 旧视图隐藏但不销毁留着他随时切回来 if (pOldView pOldView ! pNewView) pOldView-ShowWindow(SW_HIDE); RecalcLayout(); pNewView-SetFocus(); } }有几个地方我特意做了注释都是实际使用中容易出问题的。比如新视图可能已经存在于子窗口链里——如果你先前切去过那个视图再切回来直接再CreateObject会制造重复窗口句柄消息会乱。所以切换前先按运行时类类型在子窗口里找一遍找到就用现成的找不到才新建。还有隐藏旧视图而不销毁这个也是经验总结。销毁视图后这个视图对应的若干临时指针、文档关联全部失效如果你没有在别处处理好引用切回来时就是纯纯的野指针崩溃。只隐藏不销毁虽然内存占用稍微多一点但换来的是切换的稳定和快速对桌面应用来说绝对划算。2.3 触发切换的动作应该放在哪里有了SwitchView函数接下来要考虑的是谁来调用它。通常我在菜单命令、工具栏按钮或者自定义按钮的响应函数里调用调用前需要构造好CCreateContext。void CMainFrame::OnViewSwitchToOpenGL() { // 这里不能直接传NULL否则视图创建不出来 CCreateContext context; context.m_pCurrentDoc GetActiveDocument(); context.m_pNewDocTemplate NULL; context.m_pCurrentFrame this; SwitchView(RUNTIME_CLASS(COpenGLView), context); }注意GetActiveDocument()返回的是当前文档指针如果你这个文档类型能被不同视图共享那新视图也能通过GetDocument()拿到同样的数据。如果你的项目每种视图各自独立文档那就得按照“多文档模板”方案去创建上下文了。3. 实战拆解做一个“列表视图 OpenGL渲染视图”的切换工程3.1 工程结构和两个视图类准备为了展示真实的使用场景我设计了一个练手Demo在单文档框架里做两个视图CDataListView是列表视图展示MySQL查询出来的数据COpenGLView是OpenGL渲染视图根据列表里的数据绘制一个彩色四边形。两者用界面上的自定义按钮切换。视图类都继承CViewCDataListView是CListView派生的列表形式纯表格COpenGLView重写了OnDraw里面是简单的OpenGL绘制。这种一个数据源、两种展示形态的项目正好是动态替换视图方案最典型的用途。3.2 用自定义按钮触发视图切换我在主框架的工具栏上加了一个按钮并在MainFrm.h里声明消息处理函数afx_msg void OnViewSwitch();消息映射里添加ON_COMMAND(ID_VIEW_SWITCH, CMainFrame::OnViewSwitch)按钮响应函数做的事就是在两个视图类之间来回切换再加上一个静态变量记住当前状态。有一种更稳妥的方式是每次根据当前活动视图的类型判断要切到哪一个这样切换逻辑不用依赖额外状态也不容易乱。void CMainFrame::OnViewSwitch() { CView* pActive GetActiveView(); CCreateContext context; context.m_pCurrentDoc GetActiveDocument(); context.m_pNewDocTemplate NULL; context.m_pCurrentFrame this; if (pActive-IsKindOf(RUNTIME_CLASS(COpenGLView))) { SwitchView(RUNTIME_CLASS(CDataListView), context); } else { SwitchView(RUNTIME_CLASS(COpenGLView), context); } }这是最简单也最稳的写法。别用静态变量记状态万一哪次切换没走这个函数状态就错了视图和实际显示就对不上了。用IsKindOf判断永远以“现在是谁”为基准不会出错。3.3 视图切换后数据别丢既然文档对象是同一个那么列表视图拉到的MySQL数据切换成OpenGL视图后应该还能用。做法是把查询结果存到文档类成员里两个视图都通过GetDocument()拿数据。CMyDoc* pDoc (CMyDoc*)GetDocument(); if (pDoc pDoc-m_dataList.GetSize() 0) { // 渲染数据 }这样视图只管展示数据始终在文档层切换视图只是把“展示画笔”换了一把数据模型没动这是MFC文档视图架构最大的好处。切换的时候还有一个细节OnInitialUpdate()只在视图对象第一次创建的时候调用一次。如果你这个视图之前已经创建过一次再次切换回来不会重新走初始化。所以视图显示的数据刷新要么放在OnUpdate()里要么在切换函数里手动调用pNewView-OnUpdate(NULL, 0, NULL)。我建议在SwitchView里主动加一行pNewView-SendMessage(WM_PAINT)或者直接调用Invalidate触发重绘保证回来后是最新状态。4. 常见问题与排查技巧实录4.1 切了几次就崩溃的经典原因视图切换的崩溃问题十个里面有六个是窗口句柄和创建上下文的问题。我整理了一下自己踩过和帮别人解决的几类高频报错。现象根本原因解决方向第一次切换正常第二次切回时崩溃旧视图被销毁了视图对象悬空不要销毁视图用ShowWindow隐藏或确保使用前判空GetDocument()返回NULLCCreateContext没有正确传递当前文档指针初始化时显式设置context.m_pCurrentDoc新视图显示位置错乱、不占满客户区视图ID不是AFX_IDW_PANE_FIRST使用AFX_IDW_PANE_FIRST作为视图ID切换后工具栏/状态栏消失或重叠没有调用RecalcLayout切换完成后务必调用RecalcLayout()报错“Debug Assertion Failed”视图类没有DECLARE_DYNCREATE宏视图类头文件中增加DECLARE_DYNCREATE(CMyView)实现文件加IMPLEMENT_DYNCREATE第5条我特意列进来是因为RUNTIME_CLASS机制要求视图类支持动态创建如果类声明里漏了DECLARE_DYNCREATECreateObject()会直接断言失败。MFC的报错弹窗提示一般指到CDynCreateContext相关代码非常容易误判成“视图创建失败”实际就是宏没配对。4.2 调试阶段我常开的两个辅助检查在做视图切换的调试期我基本会开两个东西。第一个是_CrtSetDbgFlag(_CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF)在程序启动时开启内存泄漏检测关掉程序后在输出窗口能看到有没有泄漏的视图对象。这个对确认“到底有没有反复创建视图没有销毁”非常直观。第二个是打开VS里的“异常设置”把常见的访问冲突异常全部勾上。视图切换最容易挂的地方就是空指针调用开着异常设置崩溃的瞬间能直接定位到是哪一行代码的问题不用靠断点瞎猜。4.3 切换视图后子控件布局错乱怎么处理如果你在视图上放了自定义按钮、静态文本、列表框之类的子控件切换视图时这些控件的宿主要么跟着旧视图一起消失要么因为窗口尺寸变化而错位。我的经验是把子控件统一放到视图的OnSize里去布局用MoveWindow或者SetWindowPos按客户区尺寸动态计算位置不要在设计时用固定坐标。特别是静态文本覆盖按钮这种需求很多人直接在OnInitialUpdate里创建控件然后坐标写死。一旦窗口拉伸或者视图切换回来控件就堆在一起。把布局逻辑挪到OnSize以后虽然麻烦一点但一劳永逸。4.4 打包部署中与视图切换相关的一个隐藏坑如果你的MFC程序做完之后要拿出去部署有的情况下别人机器上运行会闪退。这种事不一定是代码问题可能是MFC运行库缺失。我在“基于MFC的MySQL查询工具”这个练手项目里遇到过调试机上跑得好好的换台机器跑起来视图刚切到全局刷新就闪退。后来查明是目标机缺了VC运行库。解决方案有两个一个是在项目属性里把“MFC的使用”改成“在静态库中使用MFC”这样exe体积会大一些但不再依赖目标机的运行库另一个是打包时带上对应的运行库安装包。如果你项目里用了MySQL的客户端库还要把libmysql.dll一起放进去否则“查找MySQL”那个控件切出来直接报错这不算视图代码问题但排查时候很容易让人误判到切换逻辑上。聊几句题外话这个需求还可以怎么扩展方案讲完了最后给想继续深挖的朋友一个方向。我后面在公司项目里没有继续用“动态替换”这种方式切视图而是改成了Tab页式客户区不放视图而是放一个CTabCtrl每一个Tab页里嵌一个视图。切换的时候只需要切换Tab页的选中项对应的视图显示/隐藏。这种形态和“动态替换”比多了标签栏交互上更接近现代软件跟用户解释成本低很多。实现思路是创建一个无边框视图容器把每个子视图创建时父窗口指向Tab控件切换Tab时通过ShowWindow控制显隐。代码量和动态替换差不多但体验确实好一截。所以如果你做的是工具型软件建议直接冲着Tab页方案去如果只是临时在两个视图间互相切动态替换仍然是最快出活的办法。在实际操作里我还发现一个通用习惯不管哪种切换方案视图里的状态滚动位置、选中项、控件文本尽量在隐藏前保存到文档对象或者视图自身的成员里切换回来时先恢复到旧状态再刷新。这个小习惯帮我解决过好多次“切回来之后列表位置丢了、用户还要重新找那一行”的尴尬问题。视图切换这件事从来不只是“显示哪个窗口”这么简单把状态管好才算真正做完了。本文还有配套的精品资源点击获取