简介一份在VC6环境下基于MFC的CListCtrl表格可编辑示例工程面向需要在单文档界面中实现列表控件就地编辑的Windows开发者解决列表默认只读、无法直接修改单元格的问题。工程演示如何继承并扩展MFC文档/视类在运行时动态创建列表控件并设置LVS_EDITLABELS样式使列表项标签进入可编辑状态同时通过消息映射响应标签编辑开始与结束事件结合控件追踪器完成编辑过程的位置控制、输入校验与数据回写并在窗口大小变化时动态调整控件布局。压缩包约3.8MB共58个文件主体为C源文件、头文件、资源与工程文件附带可执行程序与调试中间文件可直接编译运行并对照检查调用流程。已有835人学习适合需要掌握MFC消息映射、控件动态创建与列表视图扩展的中级Windows开发者是一份可运行的代码级参考。 用MFC做了这么多年Windows桌面工具CListCtrl是绕不开的表格控件。它长着表格的样子装着一颗“只读”的心双击单元格没有任何反应用户想改个数据只能整行重录。做过数据录入类程序的都知道这是个硬需求。这篇文章我把自己实现CListCtrl表格可编辑的完整方案记录下来从原理到代码再到底层细节的坑照着抄就行。适合所有用MFC做工具型桌面软件的开发者也适合刚接触控件自绘、消息映射的初学者。1. 为什么CListCtrl不能直接编辑1.1 官方机制的局限很多人第一次上手就去翻MSDN发现CListCtrl其实是带编辑能力的前提是设置LVS_EDITLABELS样式。这个样式允许用户慢慢点选标签Label进入编辑状态但有两个致命限制第一它只能编辑第一列也就是“标签列”第二编辑行为由系统内部逻辑触发开发者很难控制什么时候进入编辑、用什么字体、怎么限制输入长度。实际项目中表格要编辑的往往是第二列、第三列的数值或者备注字段。你总不能把用户要改的所有数据都挪到第一列去所以这个官方方案基本只适合做“重命名列表项”这种小需求。更麻烦的是LVS_EDITLABELS触发的编辑框在失去焦点时系统会自动结束编辑并发送LVN_ENDLABELEDIT消息开发者在这条消息里拿到的是指针稍不注意就会造成野指针访问。1.2 三种可行方案的取舍既然官方机制不够用社区里就演化出了几种自定义方案使用前必须先想清楚量级和场景。方案实现复杂度适用场景主要问题LVS_EDITLABELS LVN_ENDLABELEDIT最低只改第一列的简单列表无法编辑非首列子类化 动态CEdit嵌入中等中小型数据表、工具软件的配置界面需要自行处理消息和焦点引入第三方Grid控件较高大数据量、需要复杂单元格类型的场景依赖重、样式难以统一我最终选择的是第二种方案继承CListCtrl做子类化在需要编辑时临时创建一个CEdit盖在目标单元格上编辑完成后把文本写回去再隐藏编辑框。这个方案不需要引入任何第三方库代码量控制在两三百行以内行为完全可控后续想扩展成下拉框、日期控件也顺理成章。2. 核心原理就地编辑与消息流转2.1 一个临时的CEdit搞定一切整个方案的核心思想说穿了非常简单像在纸上贴便签一样把CEdit临时“贴”到单元格上。用户输入完毕便签上的内容被抄回表格便签撕掉。处理流程分为四步第一步检测用户双击了哪个单元格第二步根据单元格坐标创建一个CEdit子窗口大小和单元格完全一致第三步将原文本填入编辑框并把焦点交给它第四步等待用户按回车、按ESC或者点击别处此时把编辑框里的内容写回对应行列隐藏编辑框。这里有一个很容易被忽略的细节进入编辑状态后如果用户点击了表格的其他单元格要先结束当前编辑再处理新的点击否则就会出现两个编辑框叠加的混乱状态。所以我通常在OnLButtonDown里先调用EndEdit再执行基类逻辑。不要指望只靠失焦事件来兜底因为编辑框同样在ListCtrl内部失焦顺序和消息分发顺序并不总是符合直觉。2.2 坐标与文本四个关键函数要实现上述流程MFC提供了四个关键函数理解它们的功能是入门的基础。第一个是HitTest用于判断鼠标点击的是哪一行。第二个是GetSubItemRect用于获取某个单元格的矩形区域。第三个是GetItemText用于读取单元格原有文本。第四个是SetItemText用于把编辑结果写回表格。其中GetSubItemRect的用途最容易被搞错。它的第三个参数支持LVIR_BOUNDS、LVIR_LABEL、LVIR_ICON、LVIR_SELECTBOUNDS这几种取值。做可编辑表格时必须用LVIR_BOUNDS它返回的是整个单元格的矩形范围包含了边框和间距如果用LVIR_LABEL只返回文本标签区域编辑框会只覆盖住文字那一小块看起来非常别扭。此外HitTest返回的只是行号要确定列号还需要自己遍历列头。实现思路是对于给定单元格从左到右遍历每一列逐个调用GetSubItemRect判断鼠标坐标落在哪一列的范围之内。这个方法虽然朴素但非常可靠所有MFC版本的列宽计算都能正确兼容。3. 从0到1实现可编辑CListCtrl3.1 声明控件类与消息映射下面是完整可用的头文件部分包含了一个用于承载输入的CEdit子类CEditCell以及主类CEditableListCtrl。#pragma once #include afxcmn.h #define WM_END_EDIT (WM_USER 1001) class CEditableListCtrl; // 内嵌编辑框负责拦截回车、Esc和失焦消息 class CEditCell : public CEdit { public: CEditCell() : m_pOwner(NULL) {} CEditableListCtrl* m_pOwner; protected: afx_msg void OnKillFocus(CWnd* pNewWnd); virtual BOOL PreTranslateMessage(MSG* pMsg); DECLARE_MESSAGE_MAP() }; class CEditableListCtrl : public CListCtrl { public: CEditableListCtrl(); virtual ~CEditableListCtrl(); protected: CEditCell m_edit; BOOL m_bEditing; int m_nEditRow; int m_nEditCol; CString m_strOldText; int HitTestEx(CPoint point, int* pnCol); void StartEdit(int nRow, int nCol); void EndEdit(); void CancelEdit(); protected: afx_msg void OnLButtonDblClk(UINT nFlags, CPoint point); afx_msg void OnLButtonDown(UINT nFlags, CPoint point); afx_msg void OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar); afx_msg LRESULT OnEndEditMsg(WPARAM wParam, LPARAM lParam); DECLARE_MESSAGE_MAP() };几个成员变量各有分工m_bEditing是编辑状态的标志位防止重复启动编辑m_nEditRow和m_nEditCol记录当前编辑的单元格位置m_strOldText保存编辑前的旧文本用于ESC取消操作时恢复原值。CEditCell中的m_pOwner指针指向宿主ListCtrl这样编辑框就能直接通知父窗口“该收尾了”。3.2 双击触发编辑双击事件处理是整个流程的入口。MVVM就不用想了这里就是纯粹的MFC消息循环配合HitTest定位。BEGIN_MESSAGE_MAP(CEditableListCtrl, CListCtrl) ON_WM_LBUTTONDBLCLK() ON_WM_LBUTTONDOWN() ON_WM_HSCROLL() ON_MESSAGE(WM_END_EDIT, CEditableListCtrl::OnEndEditMsg) END_MESSAGE_MAP() int CEditableListCtrl::HitTestEx(CPoint point, int* pnCol) { UINT uFlags 0; int nRow HitTest(point, uFlags); *pnCol -1; if (nRow -1 || !(uFlags LVHT_ONITEM)) return -1; int nColCount GetHeaderCtrl()-GetItemCount(); for (int nCol 0; nCol nColCount; nCol) { CRect rcCell; if (GetSubItemRect(nRow, nCol, LVIR_BOUNDS, rcCell)) { if (rcCell.PtInRect(point)) { *pnCol nCol; break; } } } return nRow; } void CEditableListCtrl::OnLButtonDblClk(UINT nFlags, CPoint point) { int nCol -1; int nRow HitTestEx(point, nCol); if (nRow 0 nCol 0) { if (m_bEditing) EndEdit(); StartEdit(nRow, nCol); } CListCtrl::OnLButtonDblClk(nFlags, point); }注意HitTestEx里的LVHT_ONITEM标志这是HitTest返回坐标是否落在有效项上的关键判断。如果不加这个判断点击列表头的分隔线、控件的空白区域时也会被当成单元格点击进而触发不必要的编辑框创建。列定位的循环逻辑不复杂有一点需要留意GetSubItemRect的返回矩形是基于ListCtrl客户区坐标的如果你把ListCtrl嵌套在ScrollView或者带有其他父窗口变换的环境里拿到坐标后要先通过ClientToScreen和ScreenToClient做一次转换再创建编辑框。这个坑后面第4节还会展开说。3.3 编辑框的启停与数据回写下面这段代码是核心中的核心包含了StartEdit、EndEdit、CancelEdit三个函数。void CEditableListCtrl::StartEdit(int nRow, int nCol) { if (m_bEditing) EndEdit(); if (nRow 0 || nCol 0 || nRow GetItemCount()) return; int nColCount GetHeaderCtrl()-GetItemCount(); if (nCol nColCount) return; CRect rcCell; if (!GetSubItemRect(nRow, nCol, LVIR_BOUNDS, rcCell)) return; m_strOldText GetItemText(nRow, nCol); m_nEditRow nRow; m_nEditCol nCol; if (m_edit.GetSafeHwnd() NULL) { DWORD dwStyle WS_CHILD | WS_VISIBLE | WS_BORDER | ES_AUTOHSCROLL | ES_LEFT; m_edit.Create(dwStyle, rcCell, this, 1002); m_edit.m_pOwner this; } else { m_edit.ShowWindow(SW_SHOW); m_edit.MoveWindow(rcCell); } m_edit.SetFont(GetFont()); m_edit.SetWindowText(m_strOldText); m_edit.SetSel(0, -1); m_edit.SetFocus(); m_bEditing TRUE; } void CEditableListCtrl::EndEdit() { if (!m_bEditing) return; m_bEditing FALSE; CString strNewText; m_edit.GetWindowText(strNewText); // 判断内容是否变化减少不必要的界面刷新 if (strNewText ! m_strOldText) SetItemText(m_nEditRow, m_nEditCol, strNewText); m_edit.ShowWindow(SW_HIDE); m_nEditRow -1; m_nEditCol -1; } void CEditableListCtrl::CancelEdit() { if (!m_bEditing) return; m_bEditing FALSE; m_edit.ShowWindow(SW_HIDE); m_nEditRow -1; m_nEditCol -1; }StartEdit里有一个细节如果编辑框句柄不存在就Create存在就MoveWindow重设位置。这样设计的好处是不必频繁销毁和创建窗口性能更好也不会因为窗口重建而在调试时看到一堆“控件已销毁”的警告。EndEdit里我加了一个文本比较的判断内容没变就不写回。有人可能觉得多余但在大数据量表格里写回操作会触发LVN_ITEMCHANGED之类的通知可能引发列表排序或者自动保存逻辑白白浪费性能还容易造成闪烁。下面是CEditCell的实现用来处理回车、ESC和失焦通知BEGIN_MESSAGE_MAP(CEditCell, CEdit) ON_WM_KILLFOCUS() END_MESSAGE_MAP() BOOL CEditCell::PreTranslateMessage(MSG* pMsg) { if (pMsg-message WM_KEYDOWN) { if (pMsg-wParam VK_RETURN) { if (m_pOwner) m_pOwner-PostMessage(WM_END_EDIT, 0, 0); return TRUE; } if (pMsg-wParam VK_ESCAPE) { if (m_pOwner) m_pOwner-PostMessage(WM_END_EDIT, 1, 0); return TRUE; } } return CEdit::PreTranslateMessage(pMsg); } void CEditCell::OnKillFocus(CWnd* pNewWnd) { CEdit::OnKillFocus(pNewWnd); // 失焦时确认编辑结果这里用PostMessage避免同步回调导致递归 if (m_pOwner) m_pOwner-PostMessage(WM_END_EDIT, 0, 0); } LRESULT CEditableListCtrl::OnEndEditMsg(WPARAM wParam, LPARAM lParam) { if (wParam 1) CancelEdit(); else EndEdit(); return 0; }这段代码里最关键的是失焦处理。我之前用DestroyWindow直接销毁编辑框结果在点击其他位置时经常触发断言或者崩溃原因就是KillFocus回调过程中销毁窗口焦点系统又去访问已经销毁的窗口导致了递归访问。后来改为ShowWindow(SW_HIDE)配合PostMessage延迟处理问题彻底消失。这也是我反复强调“不要同步销毁活动编辑框”的原因。3.4 在对话框中接入自定义控件类写好了接入工程有两种方式。第一种是用DDX_Control绑定对话框成员需要先在对话框模板里放一个List Control然后把成员变量类型改成CEditableListCtrl// 对话框头文件 CEditableListCtrl m_list; // 对话框实现文件中的DoDataExchange DDX_Control(pDX, IDC_LIST1, m_list);第二种是在InitDialog里用SubclassDlgItem动态绑定m_list.SubclassDlgItem(IDC_LIST1, this); m_list.SetExtendedStyle(m_list.GetExtendedStyle() | LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES | LVS_EX_DOUBLEBUFFER);无论哪种方式都要保证ListCtrl的View属性是Report否则GetSubItemRect拿不到子项矩形整个方案直接失效。列头的添加也不能省略GetHeaderCtrl()-GetItemCount()返回0的时候编辑功能不会工作。扩展样式里建议带上LVS_EX_FULLROWSELECT这样单击选中整行用户体验更接近主流表格工具。LVS_EX_DOUBLEBUFFER可以减少刷新闪烁但如果运行环境是非主题化的旧系统这个样式偶尔会有绘制异常遇到时去掉即可。4. 实战中的坑与排查4.1 编辑框位置偏移这是最多人问的问题明明GetSubItemRect拿到了矩形创建出来的编辑框却偏了几个像素甚至出现在完全错误的位置。常见的诱因有两个一是把ListCtrl放在带滚动条的父容器里GetSubItemRect返回的坐标是相对于控件客户区的如果不做坐标转换编辑框就会按屏幕坐标放置二是DPI缩放系统缩放下ClientToScreen和ScreenToClient会自动处理但如果你的代码里混用了物理像素和逻辑像素就会错位。处理办法很简单创建前把单元格矩形转换到ListCtrl的客户区坐标系然后通过MoveWindow设置位置。如果ListCtrl本身容器有滚动条再额外加上滚动偏移量。我最常用的写法是CRect rcCell; GetSubItemRect(nRow, nCol, LVIR_BOUNDS, rcCell); ClientToScreen(rcCell); GetParent()-ScreenToClient(rcCell); m_edit.MoveWindow(rcCell);不过要提醒一句如果ListCtrl直接放在对话框上没有嵌套滚动容器那直接GetSubItemRect后MoveWindow就行不需要做坐标转换。清楚了窗口层级关系再动手避免过度转换导致新的错位。4.2 回车后内容不生效按回车后文本没有写回或者写回了又被KillFocus流程覆盖这是焦点消息顺序导致的。当你在PreTranslateMessage里按回车准备结束时焦点还留在编辑框上紧接着KillFocus消息触发也会发送一次WM_END_EDIT。如果两次处理都执行了写回第一次写回的正常数据会被第二次用旧文本覆盖掉。我的处理方式是在EndEdit里做文本比较旧文本和新文本相同时不写回同时在m_bEditing标志位已经变成FALSE时直接返回。这两个条件叠加重复回写的问题基本不会发生。如果你还是遇到了可以在OnEndEditMsg里打印日志排查消息到达顺序问题往往出在PostMessage之后消息还没被处理下一次KillFocus又发了一条。4.3 滚动和自适应宽度问题表格的滚动条是编辑框错位的重灾区。当用户正在编辑某个单元格时如果拖动水平滚动条或者改变列宽编辑框不会自动跟着移动结果就会出现“人不动编辑框飘了”的尴尬画面。需要在OnHScroll里强制结束编辑void CEditableListCtrl::OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar) { if (m_bEditing) EndEdit(); CListCtrl::OnHScroll(nSBCode, nPos, pScrollBar); }垂直滚动同理重载OnVScroll处理。还有一个隐蔽场景是鼠标滚轮触发的滚动VScroll消息也会进入OnVScroll所以这个处理能覆盖大部分滚动入口。列宽调整比较麻烦因为列宽改变走的是HDN_ITEMCHANGED通知需要自己处理。我的做法是在父对话框里截获OnNotify如果是HDN_ITEMCHANGED且编辑状态为真就先调EndEdit。这样保证列宽变化时不会出现编辑框残留。4.4 几个容易忽略的细节双击启动编辑时如果恰好是双击表头的分隔线HitTestEx返回的行号会是-1不会误触发编辑这一点倒是比较安全。真正容易踩的是点击了列表项但列号算出-1的情况比如列宽为0或者列头被拖动到看不见的位置循环判断里GetSubItemRect返回FALSE就会漏掉建议在StartEdit里多做一次列范围判断。还有关于编辑器输入法的问题。如果你的表格要录入中文编辑框默认没有IME输入法支持中文输入法弹出的候选窗口经常错位。解决方法是在CEditCell创建后调用ImmAssociateContextEx或者把它放到WM_IME_SETCONTEXT消息处理里。这算是一个进阶需求但做工具软件时经常遇到。最后是内容校验的问题。表格可编辑之后用户什么都能往里敲日期、数字、超长文本。建议在EndEdit之前根据列类型做一次校验不合格就不写回并弹一个消息提示。校验逻辑可以根据业务独立写一个虚函数以后每个列类型都覆盖一次就行。问题现象根因推荐处理编辑框位置偏移坐标未转换或DPI混用ClientToScreen再ScreenToClient编辑框跟随滚动错位滚动时未结束编辑重载OnHScroll/OnVScroll双击后出现两个编辑框未先结束上一次编辑OnLButtonDblClk里先EndEdit回车后内容被覆盖KillFocus重复写回文本比较m_bEditing防护创建编辑框后崩溃KillFocus中销毁窗口ShowWindow(SW_HIDE)PostMessage中文输入候选框错位缺少IME关联关联IME上下文这套方案在MFC自带编译器环境里属于稳定的老路子了我从VC6时代用到VS2019只要消息处理里不出现同步销毁编辑框的操作基本没有坑。如果以后表格里不仅要输文本还要下拉选状态、弹日期框核心思路完全一致把CEdit换成CComboBox或者DatePicker控件StartEdit里创建对应控件EndEdit里取值写回即可。从第一个单元格编辑功能落地到整张表成为可交互的数据录入界面隔的其实只有这一层就地编辑的壳。本文还有配套的精品资源点击获取
简介一份在VC6环境下基于MFC的CListCtrl表格可编辑示例工程面向需要在单文档界面中实现列表控件就地编辑的Windows开发者解决列表默认只读、无法直接修改单元格的问题。工程演示如何继承并扩展MFC文档/视类在运行时动态创建列表控件并设置LVS_EDITLABELS样式使列表项标签进入可编辑状态同时通过消息映射响应标签编辑开始与结束事件结合控件追踪器完成编辑过程的位置控制、输入校验与数据回写并在窗口大小变化时动态调整控件布局。压缩包约3.8MB共58个文件主体为C源文件、头文件、资源与工程文件附带可执行程序与调试中间文件可直接编译运行并对照检查调用流程。已有835人学习适合需要掌握MFC消息映射、控件动态创建与列表视图扩展的中级Windows开发者是一份可运行的代码级参考。 用MFC做了这么多年Windows桌面工具CListCtrl是绕不开的表格控件。它长着表格的样子装着一颗“只读”的心双击单元格没有任何反应用户想改个数据只能整行重录。做过数据录入类程序的都知道这是个硬需求。这篇文章我把自己实现CListCtrl表格可编辑的完整方案记录下来从原理到代码再到底层细节的坑照着抄就行。适合所有用MFC做工具型桌面软件的开发者也适合刚接触控件自绘、消息映射的初学者。1. 为什么CListCtrl不能直接编辑1.1 官方机制的局限很多人第一次上手就去翻MSDN发现CListCtrl其实是带编辑能力的前提是设置LVS_EDITLABELS样式。这个样式允许用户慢慢点选标签Label进入编辑状态但有两个致命限制第一它只能编辑第一列也就是“标签列”第二编辑行为由系统内部逻辑触发开发者很难控制什么时候进入编辑、用什么字体、怎么限制输入长度。实际项目中表格要编辑的往往是第二列、第三列的数值或者备注字段。你总不能把用户要改的所有数据都挪到第一列去所以这个官方方案基本只适合做“重命名列表项”这种小需求。更麻烦的是LVS_EDITLABELS触发的编辑框在失去焦点时系统会自动结束编辑并发送LVN_ENDLABELEDIT消息开发者在这条消息里拿到的是指针稍不注意就会造成野指针访问。1.2 三种可行方案的取舍既然官方机制不够用社区里就演化出了几种自定义方案使用前必须先想清楚量级和场景。方案实现复杂度适用场景主要问题LVS_EDITLABELS LVN_ENDLABELEDIT最低只改第一列的简单列表无法编辑非首列子类化 动态CEdit嵌入中等中小型数据表、工具软件的配置界面需要自行处理消息和焦点引入第三方Grid控件较高大数据量、需要复杂单元格类型的场景依赖重、样式难以统一我最终选择的是第二种方案继承CListCtrl做子类化在需要编辑时临时创建一个CEdit盖在目标单元格上编辑完成后把文本写回去再隐藏编辑框。这个方案不需要引入任何第三方库代码量控制在两三百行以内行为完全可控后续想扩展成下拉框、日期控件也顺理成章。2. 核心原理就地编辑与消息流转2.1 一个临时的CEdit搞定一切整个方案的核心思想说穿了非常简单像在纸上贴便签一样把CEdit临时“贴”到单元格上。用户输入完毕便签上的内容被抄回表格便签撕掉。处理流程分为四步第一步检测用户双击了哪个单元格第二步根据单元格坐标创建一个CEdit子窗口大小和单元格完全一致第三步将原文本填入编辑框并把焦点交给它第四步等待用户按回车、按ESC或者点击别处此时把编辑框里的内容写回对应行列隐藏编辑框。这里有一个很容易被忽略的细节进入编辑状态后如果用户点击了表格的其他单元格要先结束当前编辑再处理新的点击否则就会出现两个编辑框叠加的混乱状态。所以我通常在OnLButtonDown里先调用EndEdit再执行基类逻辑。不要指望只靠失焦事件来兜底因为编辑框同样在ListCtrl内部失焦顺序和消息分发顺序并不总是符合直觉。2.2 坐标与文本四个关键函数要实现上述流程MFC提供了四个关键函数理解它们的功能是入门的基础。第一个是HitTest用于判断鼠标点击的是哪一行。第二个是GetSubItemRect用于获取某个单元格的矩形区域。第三个是GetItemText用于读取单元格原有文本。第四个是SetItemText用于把编辑结果写回表格。其中GetSubItemRect的用途最容易被搞错。它的第三个参数支持LVIR_BOUNDS、LVIR_LABEL、LVIR_ICON、LVIR_SELECTBOUNDS这几种取值。做可编辑表格时必须用LVIR_BOUNDS它返回的是整个单元格的矩形范围包含了边框和间距如果用LVIR_LABEL只返回文本标签区域编辑框会只覆盖住文字那一小块看起来非常别扭。此外HitTest返回的只是行号要确定列号还需要自己遍历列头。实现思路是对于给定单元格从左到右遍历每一列逐个调用GetSubItemRect判断鼠标坐标落在哪一列的范围之内。这个方法虽然朴素但非常可靠所有MFC版本的列宽计算都能正确兼容。3. 从0到1实现可编辑CListCtrl3.1 声明控件类与消息映射下面是完整可用的头文件部分包含了一个用于承载输入的CEdit子类CEditCell以及主类CEditableListCtrl。#pragma once #include afxcmn.h #define WM_END_EDIT (WM_USER 1001) class CEditableListCtrl; // 内嵌编辑框负责拦截回车、Esc和失焦消息 class CEditCell : public CEdit { public: CEditCell() : m_pOwner(NULL) {} CEditableListCtrl* m_pOwner; protected: afx_msg void OnKillFocus(CWnd* pNewWnd); virtual BOOL PreTranslateMessage(MSG* pMsg); DECLARE_MESSAGE_MAP() }; class CEditableListCtrl : public CListCtrl { public: CEditableListCtrl(); virtual ~CEditableListCtrl(); protected: CEditCell m_edit; BOOL m_bEditing; int m_nEditRow; int m_nEditCol; CString m_strOldText; int HitTestEx(CPoint point, int* pnCol); void StartEdit(int nRow, int nCol); void EndEdit(); void CancelEdit(); protected: afx_msg void OnLButtonDblClk(UINT nFlags, CPoint point); afx_msg void OnLButtonDown(UINT nFlags, CPoint point); afx_msg void OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar); afx_msg LRESULT OnEndEditMsg(WPARAM wParam, LPARAM lParam); DECLARE_MESSAGE_MAP() };几个成员变量各有分工m_bEditing是编辑状态的标志位防止重复启动编辑m_nEditRow和m_nEditCol记录当前编辑的单元格位置m_strOldText保存编辑前的旧文本用于ESC取消操作时恢复原值。CEditCell中的m_pOwner指针指向宿主ListCtrl这样编辑框就能直接通知父窗口“该收尾了”。3.2 双击触发编辑双击事件处理是整个流程的入口。MVVM就不用想了这里就是纯粹的MFC消息循环配合HitTest定位。BEGIN_MESSAGE_MAP(CEditableListCtrl, CListCtrl) ON_WM_LBUTTONDBLCLK() ON_WM_LBUTTONDOWN() ON_WM_HSCROLL() ON_MESSAGE(WM_END_EDIT, CEditableListCtrl::OnEndEditMsg) END_MESSAGE_MAP() int CEditableListCtrl::HitTestEx(CPoint point, int* pnCol) { UINT uFlags 0; int nRow HitTest(point, uFlags); *pnCol -1; if (nRow -1 || !(uFlags LVHT_ONITEM)) return -1; int nColCount GetHeaderCtrl()-GetItemCount(); for (int nCol 0; nCol nColCount; nCol) { CRect rcCell; if (GetSubItemRect(nRow, nCol, LVIR_BOUNDS, rcCell)) { if (rcCell.PtInRect(point)) { *pnCol nCol; break; } } } return nRow; } void CEditableListCtrl::OnLButtonDblClk(UINT nFlags, CPoint point) { int nCol -1; int nRow HitTestEx(point, nCol); if (nRow 0 nCol 0) { if (m_bEditing) EndEdit(); StartEdit(nRow, nCol); } CListCtrl::OnLButtonDblClk(nFlags, point); }注意HitTestEx里的LVHT_ONITEM标志这是HitTest返回坐标是否落在有效项上的关键判断。如果不加这个判断点击列表头的分隔线、控件的空白区域时也会被当成单元格点击进而触发不必要的编辑框创建。列定位的循环逻辑不复杂有一点需要留意GetSubItemRect的返回矩形是基于ListCtrl客户区坐标的如果你把ListCtrl嵌套在ScrollView或者带有其他父窗口变换的环境里拿到坐标后要先通过ClientToScreen和ScreenToClient做一次转换再创建编辑框。这个坑后面第4节还会展开说。3.3 编辑框的启停与数据回写下面这段代码是核心中的核心包含了StartEdit、EndEdit、CancelEdit三个函数。void CEditableListCtrl::StartEdit(int nRow, int nCol) { if (m_bEditing) EndEdit(); if (nRow 0 || nCol 0 || nRow GetItemCount()) return; int nColCount GetHeaderCtrl()-GetItemCount(); if (nCol nColCount) return; CRect rcCell; if (!GetSubItemRect(nRow, nCol, LVIR_BOUNDS, rcCell)) return; m_strOldText GetItemText(nRow, nCol); m_nEditRow nRow; m_nEditCol nCol; if (m_edit.GetSafeHwnd() NULL) { DWORD dwStyle WS_CHILD | WS_VISIBLE | WS_BORDER | ES_AUTOHSCROLL | ES_LEFT; m_edit.Create(dwStyle, rcCell, this, 1002); m_edit.m_pOwner this; } else { m_edit.ShowWindow(SW_SHOW); m_edit.MoveWindow(rcCell); } m_edit.SetFont(GetFont()); m_edit.SetWindowText(m_strOldText); m_edit.SetSel(0, -1); m_edit.SetFocus(); m_bEditing TRUE; } void CEditableListCtrl::EndEdit() { if (!m_bEditing) return; m_bEditing FALSE; CString strNewText; m_edit.GetWindowText(strNewText); // 判断内容是否变化减少不必要的界面刷新 if (strNewText ! m_strOldText) SetItemText(m_nEditRow, m_nEditCol, strNewText); m_edit.ShowWindow(SW_HIDE); m_nEditRow -1; m_nEditCol -1; } void CEditableListCtrl::CancelEdit() { if (!m_bEditing) return; m_bEditing FALSE; m_edit.ShowWindow(SW_HIDE); m_nEditRow -1; m_nEditCol -1; }StartEdit里有一个细节如果编辑框句柄不存在就Create存在就MoveWindow重设位置。这样设计的好处是不必频繁销毁和创建窗口性能更好也不会因为窗口重建而在调试时看到一堆“控件已销毁”的警告。EndEdit里我加了一个文本比较的判断内容没变就不写回。有人可能觉得多余但在大数据量表格里写回操作会触发LVN_ITEMCHANGED之类的通知可能引发列表排序或者自动保存逻辑白白浪费性能还容易造成闪烁。下面是CEditCell的实现用来处理回车、ESC和失焦通知BEGIN_MESSAGE_MAP(CEditCell, CEdit) ON_WM_KILLFOCUS() END_MESSAGE_MAP() BOOL CEditCell::PreTranslateMessage(MSG* pMsg) { if (pMsg-message WM_KEYDOWN) { if (pMsg-wParam VK_RETURN) { if (m_pOwner) m_pOwner-PostMessage(WM_END_EDIT, 0, 0); return TRUE; } if (pMsg-wParam VK_ESCAPE) { if (m_pOwner) m_pOwner-PostMessage(WM_END_EDIT, 1, 0); return TRUE; } } return CEdit::PreTranslateMessage(pMsg); } void CEditCell::OnKillFocus(CWnd* pNewWnd) { CEdit::OnKillFocus(pNewWnd); // 失焦时确认编辑结果这里用PostMessage避免同步回调导致递归 if (m_pOwner) m_pOwner-PostMessage(WM_END_EDIT, 0, 0); } LRESULT CEditableListCtrl::OnEndEditMsg(WPARAM wParam, LPARAM lParam) { if (wParam 1) CancelEdit(); else EndEdit(); return 0; }这段代码里最关键的是失焦处理。我之前用DestroyWindow直接销毁编辑框结果在点击其他位置时经常触发断言或者崩溃原因就是KillFocus回调过程中销毁窗口焦点系统又去访问已经销毁的窗口导致了递归访问。后来改为ShowWindow(SW_HIDE)配合PostMessage延迟处理问题彻底消失。这也是我反复强调“不要同步销毁活动编辑框”的原因。3.4 在对话框中接入自定义控件类写好了接入工程有两种方式。第一种是用DDX_Control绑定对话框成员需要先在对话框模板里放一个List Control然后把成员变量类型改成CEditableListCtrl// 对话框头文件 CEditableListCtrl m_list; // 对话框实现文件中的DoDataExchange DDX_Control(pDX, IDC_LIST1, m_list);第二种是在InitDialog里用SubclassDlgItem动态绑定m_list.SubclassDlgItem(IDC_LIST1, this); m_list.SetExtendedStyle(m_list.GetExtendedStyle() | LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES | LVS_EX_DOUBLEBUFFER);无论哪种方式都要保证ListCtrl的View属性是Report否则GetSubItemRect拿不到子项矩形整个方案直接失效。列头的添加也不能省略GetHeaderCtrl()-GetItemCount()返回0的时候编辑功能不会工作。扩展样式里建议带上LVS_EX_FULLROWSELECT这样单击选中整行用户体验更接近主流表格工具。LVS_EX_DOUBLEBUFFER可以减少刷新闪烁但如果运行环境是非主题化的旧系统这个样式偶尔会有绘制异常遇到时去掉即可。4. 实战中的坑与排查4.1 编辑框位置偏移这是最多人问的问题明明GetSubItemRect拿到了矩形创建出来的编辑框却偏了几个像素甚至出现在完全错误的位置。常见的诱因有两个一是把ListCtrl放在带滚动条的父容器里GetSubItemRect返回的坐标是相对于控件客户区的如果不做坐标转换编辑框就会按屏幕坐标放置二是DPI缩放系统缩放下ClientToScreen和ScreenToClient会自动处理但如果你的代码里混用了物理像素和逻辑像素就会错位。处理办法很简单创建前把单元格矩形转换到ListCtrl的客户区坐标系然后通过MoveWindow设置位置。如果ListCtrl本身容器有滚动条再额外加上滚动偏移量。我最常用的写法是CRect rcCell; GetSubItemRect(nRow, nCol, LVIR_BOUNDS, rcCell); ClientToScreen(rcCell); GetParent()-ScreenToClient(rcCell); m_edit.MoveWindow(rcCell);不过要提醒一句如果ListCtrl直接放在对话框上没有嵌套滚动容器那直接GetSubItemRect后MoveWindow就行不需要做坐标转换。清楚了窗口层级关系再动手避免过度转换导致新的错位。4.2 回车后内容不生效按回车后文本没有写回或者写回了又被KillFocus流程覆盖这是焦点消息顺序导致的。当你在PreTranslateMessage里按回车准备结束时焦点还留在编辑框上紧接着KillFocus消息触发也会发送一次WM_END_EDIT。如果两次处理都执行了写回第一次写回的正常数据会被第二次用旧文本覆盖掉。我的处理方式是在EndEdit里做文本比较旧文本和新文本相同时不写回同时在m_bEditing标志位已经变成FALSE时直接返回。这两个条件叠加重复回写的问题基本不会发生。如果你还是遇到了可以在OnEndEditMsg里打印日志排查消息到达顺序问题往往出在PostMessage之后消息还没被处理下一次KillFocus又发了一条。4.3 滚动和自适应宽度问题表格的滚动条是编辑框错位的重灾区。当用户正在编辑某个单元格时如果拖动水平滚动条或者改变列宽编辑框不会自动跟着移动结果就会出现“人不动编辑框飘了”的尴尬画面。需要在OnHScroll里强制结束编辑void CEditableListCtrl::OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar) { if (m_bEditing) EndEdit(); CListCtrl::OnHScroll(nSBCode, nPos, pScrollBar); }垂直滚动同理重载OnVScroll处理。还有一个隐蔽场景是鼠标滚轮触发的滚动VScroll消息也会进入OnVScroll所以这个处理能覆盖大部分滚动入口。列宽调整比较麻烦因为列宽改变走的是HDN_ITEMCHANGED通知需要自己处理。我的做法是在父对话框里截获OnNotify如果是HDN_ITEMCHANGED且编辑状态为真就先调EndEdit。这样保证列宽变化时不会出现编辑框残留。4.4 几个容易忽略的细节双击启动编辑时如果恰好是双击表头的分隔线HitTestEx返回的行号会是-1不会误触发编辑这一点倒是比较安全。真正容易踩的是点击了列表项但列号算出-1的情况比如列宽为0或者列头被拖动到看不见的位置循环判断里GetSubItemRect返回FALSE就会漏掉建议在StartEdit里多做一次列范围判断。还有关于编辑器输入法的问题。如果你的表格要录入中文编辑框默认没有IME输入法支持中文输入法弹出的候选窗口经常错位。解决方法是在CEditCell创建后调用ImmAssociateContextEx或者把它放到WM_IME_SETCONTEXT消息处理里。这算是一个进阶需求但做工具软件时经常遇到。最后是内容校验的问题。表格可编辑之后用户什么都能往里敲日期、数字、超长文本。建议在EndEdit之前根据列类型做一次校验不合格就不写回并弹一个消息提示。校验逻辑可以根据业务独立写一个虚函数以后每个列类型都覆盖一次就行。问题现象根因推荐处理编辑框位置偏移坐标未转换或DPI混用ClientToScreen再ScreenToClient编辑框跟随滚动错位滚动时未结束编辑重载OnHScroll/OnVScroll双击后出现两个编辑框未先结束上一次编辑OnLButtonDblClk里先EndEdit回车后内容被覆盖KillFocus重复写回文本比较m_bEditing防护创建编辑框后崩溃KillFocus中销毁窗口ShowWindow(SW_HIDE)PostMessage中文输入候选框错位缺少IME关联关联IME上下文这套方案在MFC自带编译器环境里属于稳定的老路子了我从VC6时代用到VS2019只要消息处理里不出现同步销毁编辑框的操作基本没有坑。如果以后表格里不仅要输文本还要下拉选状态、弹日期框核心思路完全一致把CEdit换成CComboBox或者DatePicker控件StartEdit里创建对应控件EndEdit里取值写回即可。从第一个单元格编辑功能落地到整张表成为可交互的数据录入界面隔的其实只有这一层就地编辑的壳。本文还有配套的精品资源点击获取
