1. 项目概述为什么选择MFC来写一个记事本如果你是一个有一定C基础但主要停留在控制台程序或者标准库层面的开发者想迈入Windows桌面应用开发的大门那么“用MFC写一个记事本”这个项目绝对是一个教科书级的起点。很多人可能会问现在有Qt、有WinUI 3、有各种跨平台框架为什么还要学看起来“古老”的MFC我的回答是MFC是理解Windows桌面应用开发“底层逻辑”和“历史包袱”的最佳窗口。它直接封装了Win32 API让你在享受一定便利性的同时必须直面消息循环、窗口过程、资源管理这些核心概念。通过完成一个功能完整的记事本你不仅能掌握MFC的基本使用更能深刻理解一个Windows GUI程序是如何从无到有、如何响应用户操作、如何管理数据和界面的。这比直接使用更现代的框架能打下更坚实的地基。这个实战项目我们将从零开始使用Visual Studio 2022基于MFC的“文档/视图”架构打造一个具备新建、打开、保存、编辑、查找等核心功能的记事本。我会带你避开我当年踩过的坑比如文档序列化的陷阱、视图更新的时机、以及如何优雅地处理多字节与Unicode编码。这不仅仅是一个功能实现更是一次对经典桌面应用开发范式的深度剖析。2. 开发环境搭建与项目创建2.1 Visual Studio 2022与MFC的安装要点工欲善其事必先利其器。首先确保你安装了Visual Studio 2022。在安装时“使用C的桌面开发”这个工作负载是必须勾选的。但仅仅这样还不够MFC默认可能并未包含。你需要点击这个工作负载右侧的“修改”按钮在右侧的“安装详细信息”中找到并勾选“用于x86和x64的MFC”以及“适用于最新v143生成工具的C MFC”。这一步非常关键漏了就会在创建项目时找不到MFC模板。注意如果你的项目将来可能需要支持较旧的Windows系统如Win7可能需要额外勾选“对v142生成工具的MFC支持”但新项目通常直接使用最新的v143工具集即可。安装完成后启动Visual Studio 2022点击“创建新项目”。在搜索框输入“MFC”选择“MFC应用”这个模板。这里有个小技巧模板列表里可能还有“MFC ActiveX控件”等别选错了。项目名称我们定为MyNotepad位置按自己习惯选择。2.2 应用程序类型与项目配置详解点击“创建”后会进入“MFC应用程序向导”。这里是整个项目的骨架定义阶段每一步的选择都直接影响后续的代码结构。应用程序类型单个文档我们选择“单个文档(SDI)”。记事本一次通常只编辑一个文件SDI结构更简单直接。多文档(MDI)适合像Visual Studio本身这样的IDE。项目样式选择“Visual Studio”风格即可它提供了更现代的界面外观。文档/视图结构支持务必勾选。这是MVC模式在MFC中的体现是MFC的精髓之一能很好地将数据文档和显示视图分离。我们的记事本内容文本数据将由文档类管理而显示和编辑则在视图类中完成。复合文档支持不需要全部选择“无”。记事本不涉及OLE嵌入链接。文档模板属性文件扩展名这里我们可以填“txt”。这会影响“打开”和“保存”对话框的默认过滤器。文档类型名称填写“文本文档”。这个名称会出现在窗口标题栏等处。数据库支持不需要选择“无”。用户界面功能这里保持默认即可工具栏、状态栏、菜单栏都是我们需要的。可以勾选“初始状态栏”和“初始工具栏”。“使用经典菜单”建议取消勾选使用新的菜单风格。高级功能“打印和打印预览”可以勾选上虽然我们可能不实现复杂的打印但MFC框架提供了基础支持勾选后会自动生成相关菜单和代码框架。“ActiveX控件”不需要。“公共控件清单”保持默认启用以确保使用正确版本的ComCtl32.dll让控件有现代外观。生成的类 这是最后也是最重要的一步。向导会列出即将生成的四个核心类CMyNotepadApp: 派生自CWinAppEx代表应用程序本身全局唯一。CMainFrame: 派生自CFrameWndEx是主框架窗口管理菜单、工具栏、状态栏。CMyNotepadDoc: 派生自CDocument是我们的文档类负责保存记事本的文本内容。CMyNotepadView: 派生自CView或CEditView是我们的视图类负责显示和编辑文本。这里有一个关键决策点视图类的基类选择。默认可能是CView它是一个通用的视图需要我们自己处理文本显示和编辑这很复杂。对于记事本有一个绝佳的选择CEditView。CEditView已经内置了一个功能强大的编辑控件CEdit自动支持文本显示、编辑、复制、粘贴、撤销等基础功能。这能让我们省去90%的底层文本处理工作。因此在“生成的类”列表中选择CMyNotepadView然后在下面的“基类”下拉框中将其从CView改为CEditView。完成所有配置后点击“完成”。Visual Studio会自动生成一个具备基础框架的MFC应用程序可以直接编译运行。你会看到一个带有菜单、工具栏的空白窗口这已经是我们的记事本雏形了。3. 核心功能实现与代码剖析项目创建好后我们得到了一个能运行的“空壳”。接下来我们要注入灵魂——实现记事本的核心功能。得益于我们选择了CEditView作为视图基类很多基础编辑功能键入、删除、选择、复制粘贴已经免费获得了。我们需要聚焦于文件操作和增强功能。3.1 文档类 (CMyNotepadDoc)数据的管家文档类的核心任务是管理应用程序的数据。对于记事本数据就是文本内容。1. 序列化 (Serialize)文件读写的核心MFC通过“序列化”机制来简化文件的保存和加载。打开MyNotepadDoc.cpp文件找到CMyNotepadDoc::Serialize函数。这是框架在“打开”或“保存”文件时自动调用的。void CMyNotepadDoc::Serialize(CArchive ar) { // CEditView 已经包含了其编辑控件的序列化逻辑 // 我们只需要调用视图的序列化即可 if (ar.IsStoring()) { // TODO: 在此添加存储代码保存时 } else { // TODO: 在此添加加载代码打开时 } // 调用基类CEditView的序列化它会处理编辑控件内的文本 reinterpret_castCEditView*(m_viewList.GetHead())-SerializeRaw(ar); }上面的代码是理想情况。但这里有个大坑m_viewList.GetHead()在文档刚创建、尚未与视图关联时可能返回NULL直接reinterpret_cast会导致崩溃。更稳健的做法是void CMyNotepadDoc::Serialize(CArchive ar) { // 首先尝试序列化我们自己的文档数据如果有的话 // 例如ar m_strCustomData; // 然后序列化编辑控件的内容 POSITION pos GetFirstViewPosition(); if (pos ! NULL) { CView* pView GetNextView(pos); if (pView ! NULL pView-IsKindOf(RUNTIME_CLASS(CEditView))) { CEditView* pEditView static_castCEditView*(pView); pEditView-SerializeRaw(ar); // SerializeRaw 直接读写原始文本 } } }SerializeRaw会直接将编辑控件中的文本以纯文本格式写入文件或从文件读取完美契合记事本的需求。2. 维护修改标志 (SetModifiedFlag)文档类有一个重要的布尔标志m_bModified用于标识文档自上次保存后是否被修改。当用户编辑文本时我们需要调用SetModifiedFlag(TRUE)。通常我们会在视图类中响应编辑控件的改变消息来设置这个标志。框架会在关闭未保存的文档时自动弹出提示框。3.2 视图类 (CMyNotepadView)交互与呈现的中心视图类派生自CEditView它内部包含一个CEdit控件。我们可以通过GetEditCtrl()成员函数获取这个控件的引用从而进行更精细的控制。1. 初始化与编码处理在CMyNotepadView::OnInitialUpdate()中我们可以进行一些初始化设置比如设置字体。void CMyNotepadView::OnInitialUpdate() { CEditView::OnInitialUpdate(); // 设置一个等宽字体更适合代码或文本编辑 CFont font; font.CreatePointFont(100, _T(Consolas)); // 10pt Consolas字体 GetEditCtrl().SetFont(font); // 注意font对象不能立即销毁需要关联到控件生命周期或设为成员变量。 // 更佳实践是在视图类中定义一个 CFont 成员变量 m_font在OnCreate中创建在析构中销毁。 }编码问题是文本处理的老大难。Windows记事本饱受诟病的一点就是编码探测。我们的简易版可以这样处理默认使用SerializeRaw它依赖于当前的字符集设置。为了更好支持UnicodeUTF-16 LE我们可以重写打开/保存逻辑但复杂度激增。一个折中方案是在序列化时通过CArchive的ReadString/WriteString处理CString对象CString在Unicode编译环境下内部就是UTF-16。但这对于读取已有ANSI文件可能会乱码。对于实战项目我们优先保证功能完整编码问题可以作为一个高级议题后续优化。2. 响应编辑事件设置修改标志我们需要知道用户何时修改了文本以设置文档的修改标志。CEdit控件发送EN_CHANGE通知消息。我们在视图类中添加这个消息映射。在MyNotepadView.h的类声明中添加消息处理函数声明afx_msg void OnEnChange();在MyNotepadView.cpp的消息映射块 (BEGIN_MESSAGE_MAP) 中添加ON_EN_CHANGE(AFX_IDW_PANE_FIRST, CMyNotepadView::OnEnChange)AFX_IDW_PANE_FIRST是CEditView内部编辑控件的默认ID。然后实现该函数void CMyNotepadView::OnEnChange() { // 当编辑控件内容变化时标记文档为已修改 CMyNotepadDoc* pDoc GetDocument(); ASSERT_VALID(pDoc); if (pDoc) { pDoc-SetModifiedFlag(TRUE); } }3.3 菜单与命令处理连接用户操作资源视图 (Resource View) 是MFC管理菜单、工具栏、字符串表等资源的地方。展开MyNotepad.rc找到IDR_MAINFRAME菜单资源。我们可以看到向导已经为我们生成了“文件”、“编辑”等标准菜单项。1. 文件菜单新建、打开、保存、另存为、退出这些命令的ID是标准的如ID_FILE_NEW,ID_FILE_OPEN,ID_FILE_SAVE,ID_FILE_SAVE_AS,ID_APP_EXIT。MFC框架已经为这些命令提供了默认实现它们会自动调用文档类的OnNewDocument,OnOpenDocument,OnSaveDocument,OnSaveDocument(另存为) 以及Serialize函数。我们几乎不需要额外编写代码框架的文档/视图架构已经将其串联起来。这就是使用框架的优势。2. 编辑菜单撤销、复制、粘贴、全选等同样ID_EDIT_UNDO,ID_EDIT_CUT,ID_EDIT_COPY,ID_EDIT_PASTE,ID_EDIT_SELECT_ALL等命令由于视图基类是CEditView它已经为我们实现了这些功能菜单项会自动生效。你可以尝试运行程序输入文字然后使用这些菜单项它们都是可用的。3. 实现“查找”功能这是我们需要自己动手实现的一个关键功能。首先在菜单编辑器中在“编辑”菜单下添加一个新项“查找(F)...”设置其ID为ID_EDIT_FIND。然后我们需要处理这个命令。在CMainFrame或CMyNotepadView中处理查找通常涉及弹出对话框并与当前活动视图交互。放在视图类中更合理。在MyNotepadView.h中声明消息处理函数afx_msg void OnEditFind();在MyNotepadView.cpp的消息映射中添加ON_COMMAND(ID_EDIT_FIND, CMyNotepadView::OnEditFind)实现OnEditFind函数。我们需要创建一个“查找”对话框。MFC提供了CFindReplaceDialog类它是一个非模态对话框非常适合查找功能。// 在视图类头文件中添加成员变量 class CMyNotepadView : public CEditView { // ... private: CFindReplaceDialog* m_pFindReplaceDlg; CString m_strFind; BOOL m_bMatchCase; };// 在视图类实现文件中 void CMyNotepadView::OnEditFind() { // 如果对话框已存在则激活它 if (m_pFindReplaceDlg ! NULL) { m_pFindReplaceDlg-SetActiveWindow(); m_pFindReplaceDlg-ShowWindow(SW_SHOW); return; } // 创建非模态查找对话框 m_pFindReplaceDlg new CFindReplaceDialog; m_pFindReplaceDlg-Create(TRUE, m_strFind, NULL, FR_DOWN, this); // TRUE表示查找FALSE表示替换 // 初始化查找选项可选 m_pFindReplaceDlg-m_fr.Flags | (m_bMatchCase ? FR_MATCHCASE : 0); }创建对话框后还需要处理它发来的消息。CFindReplaceDialog通过ON_REGISTERED_MESSAGE发送WM_FINDREPLACE消息。我们需要注册并处理这个消息在消息映射中添加ON_REGISTERED_MESSAGE(CFindReplaceDialog::GetFindReplaceMsg(), CMyNotepadView::OnFindReplace)实现OnFindReplace函数在这里执行实际的文本查找逻辑使用CEdit::FindText或CString::Find。4. 工具栏按钮更新工具栏按钮的启用/禁用状态需要更新。例如“复制”、“剪切”按钮只有在有文本被选中时才应该可用。MFC通过ON_UPDATE_COMMAND_UI机制来处理。CEditView已经为我们更新了标准编辑命令的UI。如果我们添加了自定义命令如查找也需要为其添加ON_UPDATE_COMMAND_UI处理程序来更新状态。4. 界面美化与功能增强基础功能完成后我们可以让记事本变得更友好、更强大。4.1 状态栏显示行列信息一个专业的编辑器应该在状态栏显示当前光标位置第几行、第几列。MFC主框架默认有一个状态栏其ID为AFX_IDW_STATUS_BAR。在CMainFrame中定义指示器数组打开MainFrm.cpp找到indicators数组。在ID_SEPARATOR和ID_INDICATOR_CAPS之间添加我们自己的指示器ID。static UINT indicators[] { ID_SEPARATOR, // 状态行指示器用于显示行列信息 ID_INDICATOR_LINE_COL, // 自定义行列指示器 ID_INDICATOR_CAPS, ID_INDICATOR_NUM, ID_INDICATOR_SCRL, };在资源文件中定义字符串资源在“资源视图”中打开“String Table”添加一个新的字符串ID为ID_INDICATOR_LINE_COL值暂时留空程序运行时动态设置。在视图类中更新状态栏我们需要在光标移动或文本变化时更新状态栏。可以在视图类中响应EN_UPDATE消息或定时器计算当前行列号。计算行号CEdit::LineFromChar(-1)可以获取当前行索引从0开始。计算列号CEdit::LineIndex(-1)获取当前行首字符索引CEdit::GetSel()获取当前光标位置两者相减得到列号从0开始。获取主框架窗口AfxGetApp()-m_pMainWnd。获取状态栏((CMainFrame*)AfxGetApp()-m_pMainWnd)-GetStatusBar()。格式化字符串并设置CStatusBar::SetPaneText。4.2 最近文件列表 (MRU)MFC框架内置了对最近文件列表的支持。在CMyNotepadApp::InitInstance()函数中有一行代码// 启用“最近使用的文件”菜单项和工具栏 SetRegistryKey(_T(本地应用程序向导生成的应用程序)); LoadStdProfileSettings(4); // 加载标准 INI 文件选项包括 MRULoadStdProfileSettings(4)中的参数4就指定了最近文件列表的最大数量。框架会自动管理这个列表并在“文件”菜单下显示。我们不需要编写额外代码只要正确实现了文件的打开和保存这个功能就能自动工作。4.3 处理文件拖放让用户可以直接将文本文件拖拽到我们的记事本窗口打开能极大提升体验。实现这个功能非常简单只需要在CMyNotepadApp::InitInstance()函数中在创建主窗口之前调用// 启用拖放打开文件 m_pMainWnd-DragAcceptFiles(TRUE);更精确的做法是在CMainFrame::OnCreate函数末尾调用DragAcceptFiles(TRUE)。框架会收到WM_DROPFILES消息并最终调用文档类的OnOpenDocument函数。5. 编译、调试与发布5.1 解决常见的编译与链接错误MSB804: 此项目需要 MFC 库这是最常见的错误之一。原因是项目设置中MFC库的使用方式不对。右键点击项目 - “属性” - “配置属性” - “高级”将“MFC的使用”选项从“使用标准Windows库”改为“在共享DLL中使用MFC”或“在静态库中使用MFC”。前者生成文件小但运行需要目标机器有对应的MFC运行时库后者生成文件大但可独立运行。开发调试阶段建议使用“在共享DLL中使用MFC”。找不到 Windows SDK 版本确保在项目属性 - “常规” - “Windows SDK 版本”中选择了已安装的版本。字符集问题项目属性 - “高级” - “字符集”可以选择“使用Unicode字符集”或“使用多字节字符集”。现代Windows程序推荐使用Unicode能更好支持多语言。这会影响CString、TCHAR等类型的实际定义。我们的代码应使用_T()宏包裹字符串字面量以保持兼容性。5.2 调试技巧追踪MFC消息与数据TRACE 宏在调试版本中可以使用TRACE(_T(“光标位置行%d, 列%d\n”), nLine, nCol);输出调试信息到Visual Studio的输出窗口。这是最常用的MFC调试手段。SpyVisual Studio自带的工具可以查看窗口层次结构、消息流对于理解界面布局和调试消息处理非常有用。检查文档修改标志在调试时可以观察文档对象的m_bModified成员变量确认保存逻辑是否正确。5.3 发布可执行文件与依赖项编译为Release版本在工具栏的解决方案配置下拉框中选择“Release”。设置运行时库项目属性 - “C/C” - “代码生成” - “运行时库”。对于“在共享DLL中使用MFC”这里选择“多线程DLL (/MD)”对于“在静态库中使用MFC”选择“多线程 (/MT)”。Release版通常选/MD以减小体积。生成点击“生成” - “生成解决方案”。生成的可执行文件.exe位于项目目录下的x64\Release或Win32\Release文件夹中。依赖项检查如果使用“在共享DLL中使用MFC”目标计算机需要安装对应版本的Visual C Redistributable。你可以将安装包vc_redist.x64.exe与你的程序一起分发。使用静态链接/MT则无需额外运行时库但.exe文件会大很多。可以使用Dependency Walker或 Visual Studio自带的dumpbin /dependents MyNotepad.exe命令来查看动态链接的DLL。6. 进阶思考与扩展方向完成基础记事本后你可以尝试以下扩展这能让你对MFC和Windows编程的理解再深一层多文档标签页将SDI改为MDI并模仿现代编辑器在主窗口内实现标签页来切换多个文档。这涉及到自定义标签控件、管理多个文档/视图对象。语法高亮继承CEditView或使用CRichEditView重写OnDraw函数根据词法分析结果对不同部分如关键字、注释进行着色绘制。这是一个挑战性较大的功能。编码识别与转换实现类似Notepad的编码菜单ANSI, UTF-8, UTF-16 LE/BE。这需要深入理解BOM字节顺序标记和字符集转换API如MultiByteToWideChar,WideCharToMultiByte。插件系统设计一个简单的插件接口允许动态加载DLL来扩展功能如Markdown预览、代码片段管理。这涉及到动态链接库的显式加载和函数指针调用。自定义文件格式超越纯文本实现一个简单的富文本格式如RTF的保存和加载。可以使用CRichEditCtrl替代CEdit。这个MFC记事本项目就像一把钥匙帮你打开了Windows桌面开发这扇厚重的大门。过程中你对消息映射、文档视图、资源管理、GDI绘图如果做语法高亮的理解是任何抽象度更高的框架都无法替代的底层经验。当你下次再用Qt或WinUI时你会更清楚它们背后在帮你做什么从而写出更高效、更稳定的代码。
MFC实战：从零构建Windows记事本，掌握桌面开发核心
1. 项目概述为什么选择MFC来写一个记事本如果你是一个有一定C基础但主要停留在控制台程序或者标准库层面的开发者想迈入Windows桌面应用开发的大门那么“用MFC写一个记事本”这个项目绝对是一个教科书级的起点。很多人可能会问现在有Qt、有WinUI 3、有各种跨平台框架为什么还要学看起来“古老”的MFC我的回答是MFC是理解Windows桌面应用开发“底层逻辑”和“历史包袱”的最佳窗口。它直接封装了Win32 API让你在享受一定便利性的同时必须直面消息循环、窗口过程、资源管理这些核心概念。通过完成一个功能完整的记事本你不仅能掌握MFC的基本使用更能深刻理解一个Windows GUI程序是如何从无到有、如何响应用户操作、如何管理数据和界面的。这比直接使用更现代的框架能打下更坚实的地基。这个实战项目我们将从零开始使用Visual Studio 2022基于MFC的“文档/视图”架构打造一个具备新建、打开、保存、编辑、查找等核心功能的记事本。我会带你避开我当年踩过的坑比如文档序列化的陷阱、视图更新的时机、以及如何优雅地处理多字节与Unicode编码。这不仅仅是一个功能实现更是一次对经典桌面应用开发范式的深度剖析。2. 开发环境搭建与项目创建2.1 Visual Studio 2022与MFC的安装要点工欲善其事必先利其器。首先确保你安装了Visual Studio 2022。在安装时“使用C的桌面开发”这个工作负载是必须勾选的。但仅仅这样还不够MFC默认可能并未包含。你需要点击这个工作负载右侧的“修改”按钮在右侧的“安装详细信息”中找到并勾选“用于x86和x64的MFC”以及“适用于最新v143生成工具的C MFC”。这一步非常关键漏了就会在创建项目时找不到MFC模板。注意如果你的项目将来可能需要支持较旧的Windows系统如Win7可能需要额外勾选“对v142生成工具的MFC支持”但新项目通常直接使用最新的v143工具集即可。安装完成后启动Visual Studio 2022点击“创建新项目”。在搜索框输入“MFC”选择“MFC应用”这个模板。这里有个小技巧模板列表里可能还有“MFC ActiveX控件”等别选错了。项目名称我们定为MyNotepad位置按自己习惯选择。2.2 应用程序类型与项目配置详解点击“创建”后会进入“MFC应用程序向导”。这里是整个项目的骨架定义阶段每一步的选择都直接影响后续的代码结构。应用程序类型单个文档我们选择“单个文档(SDI)”。记事本一次通常只编辑一个文件SDI结构更简单直接。多文档(MDI)适合像Visual Studio本身这样的IDE。项目样式选择“Visual Studio”风格即可它提供了更现代的界面外观。文档/视图结构支持务必勾选。这是MVC模式在MFC中的体现是MFC的精髓之一能很好地将数据文档和显示视图分离。我们的记事本内容文本数据将由文档类管理而显示和编辑则在视图类中完成。复合文档支持不需要全部选择“无”。记事本不涉及OLE嵌入链接。文档模板属性文件扩展名这里我们可以填“txt”。这会影响“打开”和“保存”对话框的默认过滤器。文档类型名称填写“文本文档”。这个名称会出现在窗口标题栏等处。数据库支持不需要选择“无”。用户界面功能这里保持默认即可工具栏、状态栏、菜单栏都是我们需要的。可以勾选“初始状态栏”和“初始工具栏”。“使用经典菜单”建议取消勾选使用新的菜单风格。高级功能“打印和打印预览”可以勾选上虽然我们可能不实现复杂的打印但MFC框架提供了基础支持勾选后会自动生成相关菜单和代码框架。“ActiveX控件”不需要。“公共控件清单”保持默认启用以确保使用正确版本的ComCtl32.dll让控件有现代外观。生成的类 这是最后也是最重要的一步。向导会列出即将生成的四个核心类CMyNotepadApp: 派生自CWinAppEx代表应用程序本身全局唯一。CMainFrame: 派生自CFrameWndEx是主框架窗口管理菜单、工具栏、状态栏。CMyNotepadDoc: 派生自CDocument是我们的文档类负责保存记事本的文本内容。CMyNotepadView: 派生自CView或CEditView是我们的视图类负责显示和编辑文本。这里有一个关键决策点视图类的基类选择。默认可能是CView它是一个通用的视图需要我们自己处理文本显示和编辑这很复杂。对于记事本有一个绝佳的选择CEditView。CEditView已经内置了一个功能强大的编辑控件CEdit自动支持文本显示、编辑、复制、粘贴、撤销等基础功能。这能让我们省去90%的底层文本处理工作。因此在“生成的类”列表中选择CMyNotepadView然后在下面的“基类”下拉框中将其从CView改为CEditView。完成所有配置后点击“完成”。Visual Studio会自动生成一个具备基础框架的MFC应用程序可以直接编译运行。你会看到一个带有菜单、工具栏的空白窗口这已经是我们的记事本雏形了。3. 核心功能实现与代码剖析项目创建好后我们得到了一个能运行的“空壳”。接下来我们要注入灵魂——实现记事本的核心功能。得益于我们选择了CEditView作为视图基类很多基础编辑功能键入、删除、选择、复制粘贴已经免费获得了。我们需要聚焦于文件操作和增强功能。3.1 文档类 (CMyNotepadDoc)数据的管家文档类的核心任务是管理应用程序的数据。对于记事本数据就是文本内容。1. 序列化 (Serialize)文件读写的核心MFC通过“序列化”机制来简化文件的保存和加载。打开MyNotepadDoc.cpp文件找到CMyNotepadDoc::Serialize函数。这是框架在“打开”或“保存”文件时自动调用的。void CMyNotepadDoc::Serialize(CArchive ar) { // CEditView 已经包含了其编辑控件的序列化逻辑 // 我们只需要调用视图的序列化即可 if (ar.IsStoring()) { // TODO: 在此添加存储代码保存时 } else { // TODO: 在此添加加载代码打开时 } // 调用基类CEditView的序列化它会处理编辑控件内的文本 reinterpret_castCEditView*(m_viewList.GetHead())-SerializeRaw(ar); }上面的代码是理想情况。但这里有个大坑m_viewList.GetHead()在文档刚创建、尚未与视图关联时可能返回NULL直接reinterpret_cast会导致崩溃。更稳健的做法是void CMyNotepadDoc::Serialize(CArchive ar) { // 首先尝试序列化我们自己的文档数据如果有的话 // 例如ar m_strCustomData; // 然后序列化编辑控件的内容 POSITION pos GetFirstViewPosition(); if (pos ! NULL) { CView* pView GetNextView(pos); if (pView ! NULL pView-IsKindOf(RUNTIME_CLASS(CEditView))) { CEditView* pEditView static_castCEditView*(pView); pEditView-SerializeRaw(ar); // SerializeRaw 直接读写原始文本 } } }SerializeRaw会直接将编辑控件中的文本以纯文本格式写入文件或从文件读取完美契合记事本的需求。2. 维护修改标志 (SetModifiedFlag)文档类有一个重要的布尔标志m_bModified用于标识文档自上次保存后是否被修改。当用户编辑文本时我们需要调用SetModifiedFlag(TRUE)。通常我们会在视图类中响应编辑控件的改变消息来设置这个标志。框架会在关闭未保存的文档时自动弹出提示框。3.2 视图类 (CMyNotepadView)交互与呈现的中心视图类派生自CEditView它内部包含一个CEdit控件。我们可以通过GetEditCtrl()成员函数获取这个控件的引用从而进行更精细的控制。1. 初始化与编码处理在CMyNotepadView::OnInitialUpdate()中我们可以进行一些初始化设置比如设置字体。void CMyNotepadView::OnInitialUpdate() { CEditView::OnInitialUpdate(); // 设置一个等宽字体更适合代码或文本编辑 CFont font; font.CreatePointFont(100, _T(Consolas)); // 10pt Consolas字体 GetEditCtrl().SetFont(font); // 注意font对象不能立即销毁需要关联到控件生命周期或设为成员变量。 // 更佳实践是在视图类中定义一个 CFont 成员变量 m_font在OnCreate中创建在析构中销毁。 }编码问题是文本处理的老大难。Windows记事本饱受诟病的一点就是编码探测。我们的简易版可以这样处理默认使用SerializeRaw它依赖于当前的字符集设置。为了更好支持UnicodeUTF-16 LE我们可以重写打开/保存逻辑但复杂度激增。一个折中方案是在序列化时通过CArchive的ReadString/WriteString处理CString对象CString在Unicode编译环境下内部就是UTF-16。但这对于读取已有ANSI文件可能会乱码。对于实战项目我们优先保证功能完整编码问题可以作为一个高级议题后续优化。2. 响应编辑事件设置修改标志我们需要知道用户何时修改了文本以设置文档的修改标志。CEdit控件发送EN_CHANGE通知消息。我们在视图类中添加这个消息映射。在MyNotepadView.h的类声明中添加消息处理函数声明afx_msg void OnEnChange();在MyNotepadView.cpp的消息映射块 (BEGIN_MESSAGE_MAP) 中添加ON_EN_CHANGE(AFX_IDW_PANE_FIRST, CMyNotepadView::OnEnChange)AFX_IDW_PANE_FIRST是CEditView内部编辑控件的默认ID。然后实现该函数void CMyNotepadView::OnEnChange() { // 当编辑控件内容变化时标记文档为已修改 CMyNotepadDoc* pDoc GetDocument(); ASSERT_VALID(pDoc); if (pDoc) { pDoc-SetModifiedFlag(TRUE); } }3.3 菜单与命令处理连接用户操作资源视图 (Resource View) 是MFC管理菜单、工具栏、字符串表等资源的地方。展开MyNotepad.rc找到IDR_MAINFRAME菜单资源。我们可以看到向导已经为我们生成了“文件”、“编辑”等标准菜单项。1. 文件菜单新建、打开、保存、另存为、退出这些命令的ID是标准的如ID_FILE_NEW,ID_FILE_OPEN,ID_FILE_SAVE,ID_FILE_SAVE_AS,ID_APP_EXIT。MFC框架已经为这些命令提供了默认实现它们会自动调用文档类的OnNewDocument,OnOpenDocument,OnSaveDocument,OnSaveDocument(另存为) 以及Serialize函数。我们几乎不需要额外编写代码框架的文档/视图架构已经将其串联起来。这就是使用框架的优势。2. 编辑菜单撤销、复制、粘贴、全选等同样ID_EDIT_UNDO,ID_EDIT_CUT,ID_EDIT_COPY,ID_EDIT_PASTE,ID_EDIT_SELECT_ALL等命令由于视图基类是CEditView它已经为我们实现了这些功能菜单项会自动生效。你可以尝试运行程序输入文字然后使用这些菜单项它们都是可用的。3. 实现“查找”功能这是我们需要自己动手实现的一个关键功能。首先在菜单编辑器中在“编辑”菜单下添加一个新项“查找(F)...”设置其ID为ID_EDIT_FIND。然后我们需要处理这个命令。在CMainFrame或CMyNotepadView中处理查找通常涉及弹出对话框并与当前活动视图交互。放在视图类中更合理。在MyNotepadView.h中声明消息处理函数afx_msg void OnEditFind();在MyNotepadView.cpp的消息映射中添加ON_COMMAND(ID_EDIT_FIND, CMyNotepadView::OnEditFind)实现OnEditFind函数。我们需要创建一个“查找”对话框。MFC提供了CFindReplaceDialog类它是一个非模态对话框非常适合查找功能。// 在视图类头文件中添加成员变量 class CMyNotepadView : public CEditView { // ... private: CFindReplaceDialog* m_pFindReplaceDlg; CString m_strFind; BOOL m_bMatchCase; };// 在视图类实现文件中 void CMyNotepadView::OnEditFind() { // 如果对话框已存在则激活它 if (m_pFindReplaceDlg ! NULL) { m_pFindReplaceDlg-SetActiveWindow(); m_pFindReplaceDlg-ShowWindow(SW_SHOW); return; } // 创建非模态查找对话框 m_pFindReplaceDlg new CFindReplaceDialog; m_pFindReplaceDlg-Create(TRUE, m_strFind, NULL, FR_DOWN, this); // TRUE表示查找FALSE表示替换 // 初始化查找选项可选 m_pFindReplaceDlg-m_fr.Flags | (m_bMatchCase ? FR_MATCHCASE : 0); }创建对话框后还需要处理它发来的消息。CFindReplaceDialog通过ON_REGISTERED_MESSAGE发送WM_FINDREPLACE消息。我们需要注册并处理这个消息在消息映射中添加ON_REGISTERED_MESSAGE(CFindReplaceDialog::GetFindReplaceMsg(), CMyNotepadView::OnFindReplace)实现OnFindReplace函数在这里执行实际的文本查找逻辑使用CEdit::FindText或CString::Find。4. 工具栏按钮更新工具栏按钮的启用/禁用状态需要更新。例如“复制”、“剪切”按钮只有在有文本被选中时才应该可用。MFC通过ON_UPDATE_COMMAND_UI机制来处理。CEditView已经为我们更新了标准编辑命令的UI。如果我们添加了自定义命令如查找也需要为其添加ON_UPDATE_COMMAND_UI处理程序来更新状态。4. 界面美化与功能增强基础功能完成后我们可以让记事本变得更友好、更强大。4.1 状态栏显示行列信息一个专业的编辑器应该在状态栏显示当前光标位置第几行、第几列。MFC主框架默认有一个状态栏其ID为AFX_IDW_STATUS_BAR。在CMainFrame中定义指示器数组打开MainFrm.cpp找到indicators数组。在ID_SEPARATOR和ID_INDICATOR_CAPS之间添加我们自己的指示器ID。static UINT indicators[] { ID_SEPARATOR, // 状态行指示器用于显示行列信息 ID_INDICATOR_LINE_COL, // 自定义行列指示器 ID_INDICATOR_CAPS, ID_INDICATOR_NUM, ID_INDICATOR_SCRL, };在资源文件中定义字符串资源在“资源视图”中打开“String Table”添加一个新的字符串ID为ID_INDICATOR_LINE_COL值暂时留空程序运行时动态设置。在视图类中更新状态栏我们需要在光标移动或文本变化时更新状态栏。可以在视图类中响应EN_UPDATE消息或定时器计算当前行列号。计算行号CEdit::LineFromChar(-1)可以获取当前行索引从0开始。计算列号CEdit::LineIndex(-1)获取当前行首字符索引CEdit::GetSel()获取当前光标位置两者相减得到列号从0开始。获取主框架窗口AfxGetApp()-m_pMainWnd。获取状态栏((CMainFrame*)AfxGetApp()-m_pMainWnd)-GetStatusBar()。格式化字符串并设置CStatusBar::SetPaneText。4.2 最近文件列表 (MRU)MFC框架内置了对最近文件列表的支持。在CMyNotepadApp::InitInstance()函数中有一行代码// 启用“最近使用的文件”菜单项和工具栏 SetRegistryKey(_T(本地应用程序向导生成的应用程序)); LoadStdProfileSettings(4); // 加载标准 INI 文件选项包括 MRULoadStdProfileSettings(4)中的参数4就指定了最近文件列表的最大数量。框架会自动管理这个列表并在“文件”菜单下显示。我们不需要编写额外代码只要正确实现了文件的打开和保存这个功能就能自动工作。4.3 处理文件拖放让用户可以直接将文本文件拖拽到我们的记事本窗口打开能极大提升体验。实现这个功能非常简单只需要在CMyNotepadApp::InitInstance()函数中在创建主窗口之前调用// 启用拖放打开文件 m_pMainWnd-DragAcceptFiles(TRUE);更精确的做法是在CMainFrame::OnCreate函数末尾调用DragAcceptFiles(TRUE)。框架会收到WM_DROPFILES消息并最终调用文档类的OnOpenDocument函数。5. 编译、调试与发布5.1 解决常见的编译与链接错误MSB804: 此项目需要 MFC 库这是最常见的错误之一。原因是项目设置中MFC库的使用方式不对。右键点击项目 - “属性” - “配置属性” - “高级”将“MFC的使用”选项从“使用标准Windows库”改为“在共享DLL中使用MFC”或“在静态库中使用MFC”。前者生成文件小但运行需要目标机器有对应的MFC运行时库后者生成文件大但可独立运行。开发调试阶段建议使用“在共享DLL中使用MFC”。找不到 Windows SDK 版本确保在项目属性 - “常规” - “Windows SDK 版本”中选择了已安装的版本。字符集问题项目属性 - “高级” - “字符集”可以选择“使用Unicode字符集”或“使用多字节字符集”。现代Windows程序推荐使用Unicode能更好支持多语言。这会影响CString、TCHAR等类型的实际定义。我们的代码应使用_T()宏包裹字符串字面量以保持兼容性。5.2 调试技巧追踪MFC消息与数据TRACE 宏在调试版本中可以使用TRACE(_T(“光标位置行%d, 列%d\n”), nLine, nCol);输出调试信息到Visual Studio的输出窗口。这是最常用的MFC调试手段。SpyVisual Studio自带的工具可以查看窗口层次结构、消息流对于理解界面布局和调试消息处理非常有用。检查文档修改标志在调试时可以观察文档对象的m_bModified成员变量确认保存逻辑是否正确。5.3 发布可执行文件与依赖项编译为Release版本在工具栏的解决方案配置下拉框中选择“Release”。设置运行时库项目属性 - “C/C” - “代码生成” - “运行时库”。对于“在共享DLL中使用MFC”这里选择“多线程DLL (/MD)”对于“在静态库中使用MFC”选择“多线程 (/MT)”。Release版通常选/MD以减小体积。生成点击“生成” - “生成解决方案”。生成的可执行文件.exe位于项目目录下的x64\Release或Win32\Release文件夹中。依赖项检查如果使用“在共享DLL中使用MFC”目标计算机需要安装对应版本的Visual C Redistributable。你可以将安装包vc_redist.x64.exe与你的程序一起分发。使用静态链接/MT则无需额外运行时库但.exe文件会大很多。可以使用Dependency Walker或 Visual Studio自带的dumpbin /dependents MyNotepad.exe命令来查看动态链接的DLL。6. 进阶思考与扩展方向完成基础记事本后你可以尝试以下扩展这能让你对MFC和Windows编程的理解再深一层多文档标签页将SDI改为MDI并模仿现代编辑器在主窗口内实现标签页来切换多个文档。这涉及到自定义标签控件、管理多个文档/视图对象。语法高亮继承CEditView或使用CRichEditView重写OnDraw函数根据词法分析结果对不同部分如关键字、注释进行着色绘制。这是一个挑战性较大的功能。编码识别与转换实现类似Notepad的编码菜单ANSI, UTF-8, UTF-16 LE/BE。这需要深入理解BOM字节顺序标记和字符集转换API如MultiByteToWideChar,WideCharToMultiByte。插件系统设计一个简单的插件接口允许动态加载DLL来扩展功能如Markdown预览、代码片段管理。这涉及到动态链接库的显式加载和函数指针调用。自定义文件格式超越纯文本实现一个简单的富文本格式如RTF的保存和加载。可以使用CRichEditCtrl替代CEdit。这个MFC记事本项目就像一把钥匙帮你打开了Windows桌面开发这扇厚重的大门。过程中你对消息映射、文档视图、资源管理、GDI绘图如果做语法高亮的理解是任何抽象度更高的框架都无法替代的底层经验。当你下次再用Qt或WinUI时你会更清楚它们背后在帮你做什么从而写出更高效、更稳定的代码。
