简介「CListCtrl表格可编辑」面向在VC6/MFC环境下开发Windows单文档应用的开发者聚焦列表控件运行时创建、标签编辑与消息映射处理适合已具备C与MFC基础、希望增强数据表格交互能力的中级读者。rar压缩包共58个文件约3.8MB含h头文件、cpp源文件、rc资源、ico/bmp位图、dsp/dsw工程文件及exe、pdb、obj等编译与调试产物并附ReadMe说明便于直接打开工程对照学习。资源已有841人学习下载。示例以ControlTracker_Demo组织配合ListCtrlEx封装展示动态创建控件、LVN_BEGINLABELEDIT/LVN_ENDLABELEDIT响应、编辑校验与控件追踪等实现可帮助读者理解单文档类扩展、窗口尺寸变化时控件布局及编辑过程数据更新并从中提炼可复用的列表编辑与事件处理思路。1. CListCtrl 表格可编辑为什么得自己往表格上盖一个编辑框接手一个 VC6 老工程界面上摆着一张 CListCtrl 报表用户张口就要“双击单元格直接改”。CListCtrl 自己只认得 LVS_EDITLABELS那东西只管第一列的标签想改后面几列就得自己算好矩形、动态创建一个 CEdit 盖上去。难点从来不是把编辑框画出来而是把它做稳子项矩形要算准滚动要跟着收回车、Tab、Esc、焦点丢失这几路事件要归到一个出口不然用户改三行就能把程序点崩。这份 CListCtrl 表格可编辑的工程思路是把“就地编辑”整体收进一个 CListCtrl 派生类视图层只负责建表、插列、塞数据编辑器的创建、定位、提交、撤销全在控件内部闭环。适合手上已经有一套 MFC 单文档框架、想把只读报表改成可录入表格的人也适合想搞清楚 vc6 编程里动态创建控件和事件处理该怎么分层的人。2. 工程骨架与运行环境SDI 单文档里把列表控件动态创建起来VC6 的单文档工程和现在的手感差得远向导生成的代码里一个控件都没有视图类是空的列表控件得自己在 OnCreate 里 Create 出来。这一章先把工程骨架和编译前置条件交代清楚后面的编辑逻辑才有地方落脚。2.1 目录结构视图、文档、控件三层分开工程里真正干活的就是六七个文件剩下的都是向导生成的。把编辑器从视图里拆出去是这个工程最值得抄的一点——不然视图类会膨胀到两千行改个边框颜色都得翻半天。文件职责改动频率TableEditApp.cpp/.hCWinAppInitInstance 里注册文档模板几乎不改MainFrm.cpp/.hCFrameWnd工具栏和状态栏几乎不改TableEditDoc.cpp/.hCDocument持有行数据CArrayRowData, RowData随业务改TableEditView.cpp/.hCView创建列表控件、插列、把文档数据刷进表随界面改EditableListCtrl.cpp/.hCListCtrl 派生类就地编辑的全部逻辑核心CellEdit.cpp/.hCEdit 派生类只负责键盘和焦点核心StdAfx.h_WIN32_IE宏和公共头顺序不能乱一次定死视图和文档之间用标准的OnUpdate单向同步文档改数据、发UpdateAllViews视图收到后重刷列表。列表控件完全不认识CDocument它只对外暴露GetCellText/SetCellText和一条“某格编辑结束”的自定义消息。这一层解耦看着有点小题大做但等你后来要在同一个视图里放两张可编辑表的时候就知道省了多少事。2.2 编译环境_WIN32_IE必须写在 afxwin.h 前面VC6 配 comctl32 这套组合最容易翻车的地方是宏的顺序。CListCtrl::GetSubItemRect和SubItemHitTest在 MFC 6 的头文件里是被#if _WIN32_IE 0x0300包起来的宏没定义或者定义晚了编译直接报“no member”。这不是玄学是 MFC 6 的老毛病。// StdAfx.h —— 这两行必须放在所有 include 之前 #define VC_EXTRALEAN #define _WIN32_IE 0x0400 // 低于 0x0300 就没有 GetSubItemRect #include afxwin.h #include afxext.h #include afxcview.h #include afxcmn.h // CListCtrl / CHeaderCtrl_WIN32_IE定到 0x0400 只是编译期的事运行期还得保证系统里的 comctl32.dll 版本够。VC6 默认调InitCommonControls()那个老函数不认版本得换成InitCommonControlsEx// TableEditApp.cpp BOOL CTableEditApp::InitInstance() { INITCOMMONCONTROLSEX icc { sizeof(INITCOMMONCONTROLSEX), 0 }; icc.dwICC ICC_LISTVIEW_CLASSES | ICC_STANDARD_CLASSES; ::InitCommonControlsEx(icc); // 必须显式要 listview否则 LVS_REPORT 建不出来 CWinApp::InitInstance(); // ... 文档模板注册、主窗口创建 return TRUE; }参数说明dwSize固定填结构体大小写错了函数直接返回 FALSEdwICC是位掩码ICC_LISTVIEW_CLASSES对应SysListView32把它漏掉的话Create会失败但GetSafeHwnd()又不为 NULL新手很容易在这卡一下午。另外ICC_STANDARD_CLASSES带上后面CEdit、CButton才稳。提示如果目标机器是没打过补丁的旧系统comctl32 可能是 4.0LVM_GETSUBITEMRECT会返回 FALSE。工程里留了一个手写SendMessage的降级版本第 3 章会贴出来。2.3 视图层动态创建控件的最小改动向导生成的CTableEditView::OnCreate里本来只有一行CView::OnCreate列表控件就在这里动态建出来。注意样式里必须带LVS_REPORT否则是图标视图压根没有“单元格”这个概念。// TableEditView.h class CTableEditView : public CView { protected: CEditableListCtrl m_wndList; // 静态成员 自己 Create比 new 更省心 afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct); afx_msg void OnSize(UINT nType, int cx, int cy); DECLARE_MESSAGE_MAP() }; // TableEditView.cpp int CTableEditView::OnCreate(LPCREATESTRUCT lpCreateStruct) { if (CView::OnCreate(lpCreateStruct) -1) return -1; CRect rcClient; GetClientRect(rcClient); // 父窗口是 this子窗口 ID 由资源头文件统一分配 if (!m_wndList.Create( WS_CHILD | WS_VISIBLE | WS_BORDER | LVS_REPORT | LVS_SINGLESEL | LVS_SHOWSELALWAYS, rcClient, this, IDC_MAIN_LIST)) { TRACE(_T(列表控件创建失败检查 InitCommonControlsEx\n)); return -1; } // 扩展风格要在 Create 之后设顺序反了不生效 m_wndList.SetExtendedStyle( LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES | LVS_EX_HEADERDRAGDROP); // 编辑框继承列表字体不设的话中文会瘦一圈 m_wndList.SetFont(GetFont()); InitColumns(); // 插列编号 / 名称 / 数量 / 备注 return 0; } void CTableEditView::OnSize(UINT nType, int cx, int cy) { CView::OnSize(nType, cx, cy); if (::IsWindow(m_wndList.GetSafeHwnd())) m_wndList.MoveWindow(0, 0, cx, cy); // 不做这步窗口一拉大表格就不跟 }LVS_SINGLESEL是故意的——多选状态下“当前编辑行”会有歧义用户按住 Ctrl 点两行你到底提交哪一行LVS_SHOWSELALWAYS则是为了窗口失去焦点后还能看出选中行不然编辑框一弹出来蓝底就没了视觉上像是表格被“吃掉”了。LVS_EX_FULLROWSELECT让整行高亮配合单元格编辑体验更自然。InitColumns用InsertColumn插四列宽度可以和文档里保存的列宽联动这里不展开。到这里一张能看不能改的表就立起来了接下来的问题全在“怎么改”。3. 就地编辑的完整链路从双击命中到文本回写一次编辑动作要经过四步双击落到哪个格子、算出这个格子的屏幕矩形、把编辑框挪过去并显示、编辑结束后取值写回。这四步任何一步算错表现都是“编辑框跑到别的地方去”或者“改完没生效”。下面按链路顺序拆。3.1 命中测试双击落在哪一行哪一列NM_DBLCLK通知里带的是整张表的重绘区域不是单元格信息别指望它。正确做法是在WM_LBUTTONDBLCLK里调SubItemHitTest它一次返回行号和列号比自己拿坐标去减列宽靠谱得多。// EditableListCtrl.cpp void CEditableListCtrl::OnLButtonDblClk(UINT nFlags, CPoint point) { LVHITTESTINFO lvhi; ::ZeroMemory(lvhi, sizeof(lvhi)); lvhi.pt point; int nItem SubItemHitTest(lvhi); // nItem -1 表示点在空白区iSubItem -1 表示点在了行的右侧留白 if (nItem 0 lvhi.iSubItem 0) { SetItemState(nItem, LVIS_SELECTED | LVIS_FOCUSED, LVIS_SELECTED | LVIS_FOCUSED); StartEdit(nItem, lvhi.iSubItem); return; // 不往下传避免默认处理把焦点抢走 } CListCtrl::OnLButtonDblClk(nFlags, point); }LVHITTESTINFO的pt是客户区坐标直接用point就行不要再ClientToScreen。iSubItem在点到行尾空白区时会是 -1这个分支必须判不判就会出现“编辑框贴在最后一列右边外面”的怪现象。SubItemHitTest内部会处理列宽拖动后的偏移所以哪怕用户把列拖得乱七八糟命中依然是准的。还有一个细节双击前通常有一次单击单击已经让某行变成选中态了。这里再SetItemState一次是冗余的但它保证了“双击的格子”和“选中的行”一致后面CommitAndMove按行号递推时才不会错位。3.2 单元格矩形LVIR_BOUNDS 与第 0 列的特殊处理矩形算不准是这套方案里最高频的翻车点。LVM_GETSUBITEMRECT的用法有讲究wParam传行号lParam指向一个 RECT其left字段要预先填子项索引、top字段填LVIR_BOUNDS返回时结构体被改写成真正的坐标。// EditableListCtrl.cpp —— 取单元格矩形第 0 列单独处理 BOOL CEditableListCtrl::GetCellRect(int nRow, int nCol, CRect rc) const { rc.SetRectEmpty(); if (nRow 0 || nRow GetItemCount()) return FALSE; CHeaderCtrl* pHeader GetHeaderCtrl(); if (pHeader NULL || nCol pHeader-GetItemCount()) return FALSE; if (nCol 0) { // 第 0 列用 LVM_GETSUBITEMRECT LVIR_BOUNDS 会返回整行 // 必须用 GetItemRect 拿到行矩形再按第一列宽度截断 CRect rcRow; GetItemRect(nRow, rcRow, LVIR_BOUNDS); rcRow.right rcRow.left GetColumnWidth(0); rc rcRow; return TRUE; } rc.left nCol; // 入参子项索引 rc.top LVIR_BOUNDS; // 入参要整格区域不是标签区域 if (!SendMessage(LVM_GETSUBITEMRECT, (WPARAM)nRow, (LPARAM)rc)) return FALSE; // comctl32 太老会走到这里 return TRUE; }LVIR_BOUNDS和LVIR_LABEL的区别值得说一句前者包含图标和缩进后者只包含文本区域。做编辑框要覆盖整个格子所以用前者。第 0 列的坑是 comctl32 的既定行为文档里写得不显眼但实测确实返回整行——不截断的话双击第一列会看到一个横跨四列的编辑框。手写版本其实和上面那句SendMessage是一回事只是不走 MFC 的封装方便在_WIN32_IE定得低或者怀疑封装出错时对照排查。真机上如果LVM_GETSUBITEMRECT返回 FALSE八成是 comctl32 版本不够退回去检查 2.2 节的InitCommonControlsEx。3.3 把 CEdit 盖上去创建、定位、字体编辑框不要在每次编辑时 new 一个再 delete那是最容易漏内存的写法。整个控件只持有一个CEdit实例第一次编辑时创建之后只做MoveWindow和ShowWindow。父窗口设成列表控件自己这样编辑框的坐标系天然跟着列表走窗口移动、父窗口重绘都不用额外处理。// EditableListCtrl.cpp #define IDC_CELL_EDIT 3001 void CEditableListCtrl::StartEdit(int nRow, int nCol) { CRect rcCell; if (!GetCellRect(nRow, nCol, rcCell) || rcCell.IsRectEmpty()) return; EndEdit(TRUE); // 先收掉上一个防止两框并存 m_nEditRow nRow; m_nEditCol nCol; m_strOldText GetItemText(nRow, nCol); if (m_pEdit NULL) { m_pEdit new CCellEdit; m_pEdit-SetOwner(this); // 父窗口传 this编辑框才会被列表裁剪 if (!m_pEdit-Create(WS_CHILD | ES_AUTOHSCROLL | ES_LEFT, rcCell, this, IDC_CELL_EDIT)) { delete m_pEdit; m_pEdit NULL; return; } } // 字体必须显式设不设就是系统默认字体中文高度对不上 CFont* pFont GetFont(); m_pEdit-SetFont(pFont ! NULL ? pFont : CFont::FromHandle( (HFONT)::GetStockObject(DEFAULT_GUI_FONT))); rcCell.DeflateRect(1, 1); // 内缩 1px盖住网格线更整齐 m_pEdit-MoveWindow(rcCell); m_pEdit-SetWindowText(m_strOldText); m_pEdit-ShowWindow(SW_SHOW); m_pEdit-SetSel(0, -1); // 全选用户一打字就覆盖原值 m_pEdit-SetFocus(); }ES_AUTOHSCROLL不能少长文本靠它横向滚动否则编辑框里看到的是被截断的半截内容。DeflateRect(1, 1)让编辑框边框和网格线错开视觉上更服帖不内缩也能用就是边缘会压住网格线显得脏。还有一点SetFocus之后光标在编辑框里列表控件就失去了焦点LVS_SHOWSELALWAYS此时开始发挥作用——没有它选中行会变成灰色用户根本不知道自己正在改哪一行。3.4 提交与撤销三路事件归一到一个 EndEdit回车、Tab、Esc、点到别处导致焦点丢失这四件事最后都要走同一个函数否则四种路径四份逻辑迟早有一份写漏。工程的写法是一个EndEdit(BOOL bSave)兜底CancelEdit和CommitAndMove都只是它的薄封装。// EditableListCtrl.cpp void CEditableListCtrl::EndEdit(BOOL bSave) { if (m_pEdit NULL || !::IsWindow(m_pEdit-GetSafeHwnd())) return; if (m_nEditRow 0) return; m_bInCommit TRUE; // 防重入见第 5 章 int nRow m_nEditRow; int nCol m_nEditCol; m_nEditRow m_nEditCol -1; CString strNew; m_pEdit-GetWindowText(strNew); m_pEdit-ShowWindow(SW_HIDE); if (bSave strNew ! m_strOldText) { SetItemText(nRow, nCol, strNew); RedrawItems(nRow, nRow); // 不重绘会残留旧文本 UpdateWindow(); // 自定义消息通知视图行、列、旧值、新值 NMLISTEDIT nm; nm.hdr.hwndFrom GetSafeHwnd(); nm.hdr.idFrom GetDlgCtrlID(); nm.hdr.code NM_CELLEDIT_END; nm.nRow nRow; nm.nCol nCol; nm.strOld m_strOldText; nm.strNew strNew; GetParent()-SendMessage(WM_CELLEDIT_END, 0, (LPARAM)nm); } else { RedrawItems(nRow, nRow); // 取消也要重绘擦掉编辑框残留 } m_bInCommit FALSE; } void CEditableListCtrl::CancelEdit() { EndEdit(FALSE); SetFocus(); // 焦点还给列表键盘还能继续走 } void CEditableListCtrl::CommitAndMove(int nColDelta, int nRowDelta) { int nRow m_nEditRow, nCol m_nEditCol; EndEdit(TRUE); if (nRow 0) return; int nNextRow nRow nRowDelta; int nNextCol nCol nColDelta; CHeaderCtrl* pHeader GetHeaderCtrl(); if (pHeader NULL) return; // 越界就回绕别让用户按 Tab 到最后一格后卡死 if (nNextCol pHeader-GetItemCount()) { nNextCol 0; nNextRow; } if (nNextCol 0) { nNextCol pHeader-GetItemCount() - 1; nNextRow--; } if (nNextRow 0 nNextRow GetItemCount()) { SetItemState(nNextRow, LVIS_SELECTED | LVIS_FOCUSED, LVIS_SELECTED | LVIS_FOCUSED); EnsureVisible(nNextRow, FALSE); // 跨屏时必须滚动到可见 StartEdit(nNextRow, nNextCol); } }RedrawItems加UpdateWindow这个组合不能省。只调SetItemText的话列表控件会把自己的重绘排进消息队列而编辑框刚隐藏那一块区域在重绘到来之前是空白的用户看到的是“改完的字闪了一下才出现”。UpdateWindow强制立刻重绘体验上干脆很多。SendMessage而不是PostMessage是有意的视图收到消息后可能要立刻校验输入、甚至把非法值回滚这些动作必须在编辑状态彻底结束之前完成。用PostMessage的话消息还在队列里用户可能已经点到下一个格子了。4. 控件封装与事件处理CEdit 子类化、自定义通知和文档视图对接第 3 章把链路拉通了但还有三件事没解决回车在CEdit里默认是“叮”一声什么都不做Tab 会被对话框机制吃掉焦点丢失时提交会引发重入。这三件事都指向同一个手段——把CEdit子类化。4.1 为什么把编辑器塞进控件派生类而不是写在视图里最直观的写法是视图类里ON_WM_LBUTTONDBLCLK、ON_WM_VSCROLL、ON_WM_KILLFOCUS一把梭反正都能跑。但这么写有三个后患视图里要额外维护“当前编辑行/列/旧文本”三个成员滚动条消息是列表控件收到的视图拦不到只能靠反射或者子类化最要命的是第二张表加进来的时候所有这些都要复制一遍。把CEditableListCtrl做成派生类的收益就在这编辑状态是控件自己的私有数据滚动消息天然能收到谁想用就在自己的视图里放一个成员。视图那边只需要处理一条自定义通知剩下的完全不关心。代价是多两个文件、多点DECLARE_DYNAMIC值。// EditableListCtrl.h #define WM_CELLEDIT_END (WM_USER 120) // 视图 → 控件 的方向不用它 struct NMLISTEDIT { NMHDR hdr; int nRow; int nCol; CString strOld; CString strNew; }; class CEditableListCtrl : public CListCtrl { DECLARE_DYNAMIC(CEditableListCtrl) public: CEditableListCtrl(); virtual ~CEditableListCtrl(); BOOL GetCellText(int nRow, int nCol, CString str) const; BOOL SetCellText(int nRow, int nCol, LPCTSTR lpszText); void StartEdit(int nRow, int nCol); void EndEdit(BOOL bSave); void CancelEdit(); void CommitAndMove(int nColDelta, int nRowDelta); void OnEditorLostFocus(); // 给 CCellEdit 回调 protected: CCellEdit* m_pEdit; int m_nEditRow, m_nEditCol; CString m_strOldText; BOOL m_bInCommit; BOOL GetCellRect(int nRow, int nCol, CRect rc) const; afx_msg void OnLButtonDblClk(UINT nFlags, CPoint point); afx_msg void OnVScroll(UINT nSBCode, UINT nPos, CScrollBar* pBar); afx_msg void OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pBar); afx_msg void OnMouseWheel(UINT nFlags, short zDelta, CPoint pt); afx_msg void OnDestroy(); DECLARE_MESSAGE_MAP() };NMLISTEDIT的第一个成员必须是NMHDR这样视图那边可以按标准通知的写法走OnNotify统一分发也可以直接用ON_MESSAGE接WM_CELLEDIT_END。工程里选了后者因为WM_USER 120这个自定义消息号在本视图里独占用起来更直接。4.2 CCellEdit拦键盘、吃掉 Tab、避免重入CEdit默认对回车没反应单行编辑框会响一声系统提示音对 Tab 则是把焦点交给下一个控件——在表格编辑场景里这两个行为都不对。子类化之后在OnKeyDown里截住就行。// CellEdit.cpp IMPLEMENT_DYNAMIC(CCellEdit, CEdit) BEGIN_MESSAGE_MAP(CCellEdit, CEdit) ON_WM_KEYDOWN() ON_WM_KILLFOCUS() END_MESSAGE_MAP() void CCellEdit::OnKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags) { switch (nChar) { case VK_RETURN: if (m_pOwner) m_pOwner-CommitAndMove(0, 1); // 提交下移一行 return; // 不调基类避免提示音 case VK_TAB: if (m_pOwner) m_pOwner-CommitAndMove(1, 0); // 提交右移一列 return; case VK_ESCAPE: if (m_pOwner) m_pOwner-CancelEdit(); // 丢弃还原旧值 return; } CEdit::OnKeyDown(nChar, nRepCnt, nFlags); } void CCellEdit::OnKillFocus(CWnd* pNewWnd) { CEdit::OnKillFocus(pNewWnd); if (m_pOwner ! NULL) m_pOwner-OnEditorLostFocus(); // 统一出口内部有重入保护 }三个return的位置很关键。如果在VK_RETURN分支里忘了return基类CEdit::OnKeyDown还会处理一遍表现就是“提交了两次”或者“提交后又响一声”。VK_TAB同理基类会调GetNextDlgTabItem把焦点甩出去编辑框还没提交就失焦了。OnKillFocus里调OnEditorLostFocus而不是直接EndEdit(TRUE)是因为CommitAndMove内部会先EndEdit再SetFocus到列表这条路径上焦点会变两次第二次触发KillFocus时m_nEditRow已经是 -1直接EndEdit也能挡住但中间会多做一次GetWindowText。加一层回调语义更清楚void CEditableListCtrl::OnEditorLostFocus() { if (m_bInCommit) return; // 正在提交别插一脚 EndEdit(TRUE); }4.3 自定义通知把“某格改完了”干净地回传给视图SetItemText之后父窗口能收到的通知有限LVN_ITEMCHANGED主要在选中态和状态位变化时来指望它感知文本修改容易踩空。与其去猜不如自己发一条消息字段想带什么带什么。// TableEditView.cpp BEGIN_MESSAGE_MAP(CTableEditView, CView) ON_WM_CREATE() ON_WM_SIZE() ON_MESSAGE(WM_CELLEDIT_END, OnCellEditEnd) END_MESSAGE_MAP() LRESULT CTableEditView::OnCellEditEnd(WPARAM wParam, LPARAM lParam) { NMLISTEDIT* p (NMLISTEDIT*)lParam; if (p NULL) return 0; // 1) 业务校验数量列必须是正整数 if (p-nCol COL_QTY) { int nVal _ttoi(p-strNew); if (nVal 0) { AfxMessageBox(_T(数量必须是大于 0 的整数)); m_wndList.SetItemText(p-nRow, p-nCol, p-strOld); // 回滚 return 0; } } // 2) 写回文档文档负责脏标记和撤销栈 CTableEditDoc* pDoc GetDocument(); pDoc-SetCellValue(p-nRow, p-nCol, p-strNew); pDoc-SetModifiedFlag(TRUE); // 关窗口时才会提示保存 return 0; }注意lParam指向的是栈上的局部结构体SendMessage是同步调用视图处理完才返回所以指针有效。换成PostMessage就悬空了——这是很多人都踩过的坑改个函数名程序就随机崩。SetModifiedFlag(TRUE)那一行容易被忘。忘了的后果是关窗口不提示保存用户改了半天点叉直接没了血泪教训。4.4 与文档/视图对接改数据不重建表OnUpdate里最省事的写法是DeleteAllItems()然后全量重刷数据量小的时候无所谓几千行的时候每次编辑都闪一下体验很差。工程里用一个m_nRefreshing标志挡住回环只在列结构变化时才重建void CTableEditView::OnUpdate(CView* pSender, LPARAM lHint, CObject* pHint) { if (m_nRefreshing 0) return; // 自己触发的更新直接忽略 CTableEditDoc* pDoc GetDocument(); if (lHint HINT_COLUMNS_CHANGED) { m_wndList.DeleteAllItems(); FillAllRows(pDoc); // 结构变了才全量重建 } else { m_wndList.RefreshVisibleRows(pDoc); // 只回写可见行的文本 } }RefreshVisibleRows大致就是遍历GetTopIndex()到GetTopIndex() GetCountPerPage()之间的行逐个SetItemText。行数上千的时候这一招很有效因为它只碰屏幕上那二十来行其余的下次滚到了再刷。5. 排查清单编辑框错位、闪退、焦点乱跳的五种现场这套代码在几台机器上跑过之后问题基本都集中在下面五类。每一条我都按“现象—原因—解决”记下来照着对能省不少调试时间。5.1 现象编译报GetSubItemRect不是 CListCtrl 的成员原因几乎只有一个StdAfx.h里_WIN32_IE没定义或者定义在了#include afxwin.h之后。MFC 6 的afxcmn.h用预处理把这两个函数包了起来宏不到位就等于不存在。VC6 的工程设置里C/C → Preprocessor definitions那一栏也能加但工程选项和StdAfx.h两处都写反而容易打架统一放StdAfx.h最省事。解决把#define _WIN32_IE 0x0400挪到文件第一行#include全部放到它后面然后 Rebuild All。只做 Build 有时候增量编译不会重编StdAfx.h依赖的文件宏改了跟没改一样。5.2 现象双击第一列编辑框横跨整行原因在 3.2 节讲过——LVM_GETSUBITEMRECT对iSubItem 0加LVIR_BOUNDS的组合返回的是整行矩形不是第一列。这个行为在文档里描述得很含糊实测才看得出来。解决第 0 列走GetItemRect(nRow, rc, LVIR_BOUNDS)拿行矩形再把rc.right改成rc.left GetColumnWidth(0)。如果想更精细也可以把LVIR_BOUNDS换成LVIR_LABEL再加回缩进量但列宽版本更直观。5.3 现象一滚滚轮或者拖滚动条编辑框就悬在半空原因编辑框是列表控件的子窗口父窗口客户区原点一动子窗口不会自动跟着重定位。列表控件滚动时移动的是内部绘制内容不是窗口本身所以编辑框还停在原来的屏幕位置看起来就像“贴在表格上的一块补丁”。解决在派生类里拦WM_VSCROLL、WM_HSCROLL、WM_MOUSEWHEEL先EndEdit(TRUE)再交给基类void CEditableListCtrl::OnVScroll(UINT nSBCode, UINT nPos, CScrollBar* pBar) { EndEdit(TRUE); // 先收再滚 CListCtrl::OnVScroll(nSBCode, nPos, pBar); }OnMouseWheel的写法一样参数签名是(UINT nFlags, short zDelta, CPoint pt)。别只拦WM_VSCROLL就完事滚轮走的是另一条消息只拦一个的话鼠标滚轮照样出问题。5.4 现象改完一格后偶尔崩溃调用栈停在SetItemText里面原因重入。OnKillFocus里调EndEdit→EndEdit里SetItemText→ 列表重绘 → 某些情况下焦点再次变化 → 又进OnKillFocus→m_nEditRow已被改成 -1 但m_pEdit还在 → 取到非法行号。解决加m_bInCommit标志EndEdit进来先置 TRUE退出前置 FALSEOnEditorLostFocus第一行判断这个标志直接返回。另外EndEdit里取完窗口文本要立刻ShowWindow(SW_HIDE)让编辑框先消失再做写值动作顺序反了也会加重绘冲突。5.5 现象中文显示成方框或者编辑框比单元格高一截原因编辑框没设字体用的是系统默认 GUI 字体而列表控件可能被SetFont换成了宋体 9 号。两者字高不一样编辑框就会出现“文字偏上”或者“边框压住下一行”的观感。多显示器不同 DPI 的环境下更明显。解决StartEdit里统一m_pEdit-SetFont(GetFont())GetFont()返回 NULL 时退回DEFAULT_GUI_FONT。如果列表用了自定义字体记得CFont对象的生命周期要长于编辑框别在局部作用域里CreateFont然后让编辑框引用——那是标准的悬空句柄表现是文字随机变成乱码。6. 二次开发从单格编辑到列校验、虚表和大数据量提交这套骨架能跑之后真正的工作量在“往上加东西”。我一般的顺序是先加列级校验再考虑数据量大时的虚表改造。列级校验最简单的做法是把校验规则抽成一个小结构体数组按列索引查表别在OnCellEditEnd里堆if-elsestruct COL_RULE { int nCol; LPCTSTR lpszTip; BOOL (*pfnCheck)(LPCTSTR); }; static BOOL CheckPositive(LPCTSTR s) { return _ttoi(s) 0; } static BOOL CheckNotEmpty(LPCTSTR s) { return s ! NULL *s ! _T(\0); } static const COL_RULE g_Rules[] { { COL_NAME, _T(名称不能为空), CheckNotEmpty }, { COL_QTY, _T(数量必须是正整数), CheckPositive }, };查表命中就调函数指针没命中直接放行。好处是新增一列只加一行配置不用动主流程坏处是函数指针没法捕获上下文遇到“数量不能超过库存”这种要查库的规则就得换虚函数或者std::function——VC6 没std::function用抽象基类加new更实际。再往上是虚表。行数过万的时候InsertItem一行一行塞会明显卡顿改成LVS_OWNERDATA加LVN_GETDISPINFO只在系统要显示某行时才回填文本内存和速度都能接受。但虚表有个副作用SetItemText不再能改数据得改成“写回数据源 RedrawItems”第 3 章的EndEdit要动一处。改造前先确认数据源本身支持按行随机访问用CArray就行用链表就得先换容器。还有一个我踩过的坑批量粘贴。用户从 Excel 复制一片区域贴进来OnCellEditEnd会连着触发几十次每次都SendMessage回视图去做校验和SetModifiedFlag中间还夹着重绘请求卡得肉眼可见。后来改成编辑期间只往一个待提交队列里塞用PostMessage起一个合并处理一轮消息循环只刷一次界面才顺畅起来。从那以后我每次动这类表格编辑的代码都强制自己先在真机上把“双击—改字—滚轮—Tab—Esc—关窗口”这一串走一遍再去看内存。因为这套东西的问题从来不写在编译错误里它只在用户手里出现。希望帮到你。本文还有配套的精品资源点击获取
简介「CListCtrl表格可编辑」面向在VC6/MFC环境下开发Windows单文档应用的开发者聚焦列表控件运行时创建、标签编辑与消息映射处理适合已具备C与MFC基础、希望增强数据表格交互能力的中级读者。rar压缩包共58个文件约3.8MB含h头文件、cpp源文件、rc资源、ico/bmp位图、dsp/dsw工程文件及exe、pdb、obj等编译与调试产物并附ReadMe说明便于直接打开工程对照学习。资源已有841人学习下载。示例以ControlTracker_Demo组织配合ListCtrlEx封装展示动态创建控件、LVN_BEGINLABELEDIT/LVN_ENDLABELEDIT响应、编辑校验与控件追踪等实现可帮助读者理解单文档类扩展、窗口尺寸变化时控件布局及编辑过程数据更新并从中提炼可复用的列表编辑与事件处理思路。1. CListCtrl 表格可编辑为什么得自己往表格上盖一个编辑框接手一个 VC6 老工程界面上摆着一张 CListCtrl 报表用户张口就要“双击单元格直接改”。CListCtrl 自己只认得 LVS_EDITLABELS那东西只管第一列的标签想改后面几列就得自己算好矩形、动态创建一个 CEdit 盖上去。难点从来不是把编辑框画出来而是把它做稳子项矩形要算准滚动要跟着收回车、Tab、Esc、焦点丢失这几路事件要归到一个出口不然用户改三行就能把程序点崩。这份 CListCtrl 表格可编辑的工程思路是把“就地编辑”整体收进一个 CListCtrl 派生类视图层只负责建表、插列、塞数据编辑器的创建、定位、提交、撤销全在控件内部闭环。适合手上已经有一套 MFC 单文档框架、想把只读报表改成可录入表格的人也适合想搞清楚 vc6 编程里动态创建控件和事件处理该怎么分层的人。2. 工程骨架与运行环境SDI 单文档里把列表控件动态创建起来VC6 的单文档工程和现在的手感差得远向导生成的代码里一个控件都没有视图类是空的列表控件得自己在 OnCreate 里 Create 出来。这一章先把工程骨架和编译前置条件交代清楚后面的编辑逻辑才有地方落脚。2.1 目录结构视图、文档、控件三层分开工程里真正干活的就是六七个文件剩下的都是向导生成的。把编辑器从视图里拆出去是这个工程最值得抄的一点——不然视图类会膨胀到两千行改个边框颜色都得翻半天。文件职责改动频率TableEditApp.cpp/.hCWinAppInitInstance 里注册文档模板几乎不改MainFrm.cpp/.hCFrameWnd工具栏和状态栏几乎不改TableEditDoc.cpp/.hCDocument持有行数据CArrayRowData, RowData随业务改TableEditView.cpp/.hCView创建列表控件、插列、把文档数据刷进表随界面改EditableListCtrl.cpp/.hCListCtrl 派生类就地编辑的全部逻辑核心CellEdit.cpp/.hCEdit 派生类只负责键盘和焦点核心StdAfx.h_WIN32_IE宏和公共头顺序不能乱一次定死视图和文档之间用标准的OnUpdate单向同步文档改数据、发UpdateAllViews视图收到后重刷列表。列表控件完全不认识CDocument它只对外暴露GetCellText/SetCellText和一条“某格编辑结束”的自定义消息。这一层解耦看着有点小题大做但等你后来要在同一个视图里放两张可编辑表的时候就知道省了多少事。2.2 编译环境_WIN32_IE必须写在 afxwin.h 前面VC6 配 comctl32 这套组合最容易翻车的地方是宏的顺序。CListCtrl::GetSubItemRect和SubItemHitTest在 MFC 6 的头文件里是被#if _WIN32_IE 0x0300包起来的宏没定义或者定义晚了编译直接报“no member”。这不是玄学是 MFC 6 的老毛病。// StdAfx.h —— 这两行必须放在所有 include 之前 #define VC_EXTRALEAN #define _WIN32_IE 0x0400 // 低于 0x0300 就没有 GetSubItemRect #include afxwin.h #include afxext.h #include afxcview.h #include afxcmn.h // CListCtrl / CHeaderCtrl_WIN32_IE定到 0x0400 只是编译期的事运行期还得保证系统里的 comctl32.dll 版本够。VC6 默认调InitCommonControls()那个老函数不认版本得换成InitCommonControlsEx// TableEditApp.cpp BOOL CTableEditApp::InitInstance() { INITCOMMONCONTROLSEX icc { sizeof(INITCOMMONCONTROLSEX), 0 }; icc.dwICC ICC_LISTVIEW_CLASSES | ICC_STANDARD_CLASSES; ::InitCommonControlsEx(icc); // 必须显式要 listview否则 LVS_REPORT 建不出来 CWinApp::InitInstance(); // ... 文档模板注册、主窗口创建 return TRUE; }参数说明dwSize固定填结构体大小写错了函数直接返回 FALSEdwICC是位掩码ICC_LISTVIEW_CLASSES对应SysListView32把它漏掉的话Create会失败但GetSafeHwnd()又不为 NULL新手很容易在这卡一下午。另外ICC_STANDARD_CLASSES带上后面CEdit、CButton才稳。提示如果目标机器是没打过补丁的旧系统comctl32 可能是 4.0LVM_GETSUBITEMRECT会返回 FALSE。工程里留了一个手写SendMessage的降级版本第 3 章会贴出来。2.3 视图层动态创建控件的最小改动向导生成的CTableEditView::OnCreate里本来只有一行CView::OnCreate列表控件就在这里动态建出来。注意样式里必须带LVS_REPORT否则是图标视图压根没有“单元格”这个概念。// TableEditView.h class CTableEditView : public CView { protected: CEditableListCtrl m_wndList; // 静态成员 自己 Create比 new 更省心 afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct); afx_msg void OnSize(UINT nType, int cx, int cy); DECLARE_MESSAGE_MAP() }; // TableEditView.cpp int CTableEditView::OnCreate(LPCREATESTRUCT lpCreateStruct) { if (CView::OnCreate(lpCreateStruct) -1) return -1; CRect rcClient; GetClientRect(rcClient); // 父窗口是 this子窗口 ID 由资源头文件统一分配 if (!m_wndList.Create( WS_CHILD | WS_VISIBLE | WS_BORDER | LVS_REPORT | LVS_SINGLESEL | LVS_SHOWSELALWAYS, rcClient, this, IDC_MAIN_LIST)) { TRACE(_T(列表控件创建失败检查 InitCommonControlsEx\n)); return -1; } // 扩展风格要在 Create 之后设顺序反了不生效 m_wndList.SetExtendedStyle( LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES | LVS_EX_HEADERDRAGDROP); // 编辑框继承列表字体不设的话中文会瘦一圈 m_wndList.SetFont(GetFont()); InitColumns(); // 插列编号 / 名称 / 数量 / 备注 return 0; } void CTableEditView::OnSize(UINT nType, int cx, int cy) { CView::OnSize(nType, cx, cy); if (::IsWindow(m_wndList.GetSafeHwnd())) m_wndList.MoveWindow(0, 0, cx, cy); // 不做这步窗口一拉大表格就不跟 }LVS_SINGLESEL是故意的——多选状态下“当前编辑行”会有歧义用户按住 Ctrl 点两行你到底提交哪一行LVS_SHOWSELALWAYS则是为了窗口失去焦点后还能看出选中行不然编辑框一弹出来蓝底就没了视觉上像是表格被“吃掉”了。LVS_EX_FULLROWSELECT让整行高亮配合单元格编辑体验更自然。InitColumns用InsertColumn插四列宽度可以和文档里保存的列宽联动这里不展开。到这里一张能看不能改的表就立起来了接下来的问题全在“怎么改”。3. 就地编辑的完整链路从双击命中到文本回写一次编辑动作要经过四步双击落到哪个格子、算出这个格子的屏幕矩形、把编辑框挪过去并显示、编辑结束后取值写回。这四步任何一步算错表现都是“编辑框跑到别的地方去”或者“改完没生效”。下面按链路顺序拆。3.1 命中测试双击落在哪一行哪一列NM_DBLCLK通知里带的是整张表的重绘区域不是单元格信息别指望它。正确做法是在WM_LBUTTONDBLCLK里调SubItemHitTest它一次返回行号和列号比自己拿坐标去减列宽靠谱得多。// EditableListCtrl.cpp void CEditableListCtrl::OnLButtonDblClk(UINT nFlags, CPoint point) { LVHITTESTINFO lvhi; ::ZeroMemory(lvhi, sizeof(lvhi)); lvhi.pt point; int nItem SubItemHitTest(lvhi); // nItem -1 表示点在空白区iSubItem -1 表示点在了行的右侧留白 if (nItem 0 lvhi.iSubItem 0) { SetItemState(nItem, LVIS_SELECTED | LVIS_FOCUSED, LVIS_SELECTED | LVIS_FOCUSED); StartEdit(nItem, lvhi.iSubItem); return; // 不往下传避免默认处理把焦点抢走 } CListCtrl::OnLButtonDblClk(nFlags, point); }LVHITTESTINFO的pt是客户区坐标直接用point就行不要再ClientToScreen。iSubItem在点到行尾空白区时会是 -1这个分支必须判不判就会出现“编辑框贴在最后一列右边外面”的怪现象。SubItemHitTest内部会处理列宽拖动后的偏移所以哪怕用户把列拖得乱七八糟命中依然是准的。还有一个细节双击前通常有一次单击单击已经让某行变成选中态了。这里再SetItemState一次是冗余的但它保证了“双击的格子”和“选中的行”一致后面CommitAndMove按行号递推时才不会错位。3.2 单元格矩形LVIR_BOUNDS 与第 0 列的特殊处理矩形算不准是这套方案里最高频的翻车点。LVM_GETSUBITEMRECT的用法有讲究wParam传行号lParam指向一个 RECT其left字段要预先填子项索引、top字段填LVIR_BOUNDS返回时结构体被改写成真正的坐标。// EditableListCtrl.cpp —— 取单元格矩形第 0 列单独处理 BOOL CEditableListCtrl::GetCellRect(int nRow, int nCol, CRect rc) const { rc.SetRectEmpty(); if (nRow 0 || nRow GetItemCount()) return FALSE; CHeaderCtrl* pHeader GetHeaderCtrl(); if (pHeader NULL || nCol pHeader-GetItemCount()) return FALSE; if (nCol 0) { // 第 0 列用 LVM_GETSUBITEMRECT LVIR_BOUNDS 会返回整行 // 必须用 GetItemRect 拿到行矩形再按第一列宽度截断 CRect rcRow; GetItemRect(nRow, rcRow, LVIR_BOUNDS); rcRow.right rcRow.left GetColumnWidth(0); rc rcRow; return TRUE; } rc.left nCol; // 入参子项索引 rc.top LVIR_BOUNDS; // 入参要整格区域不是标签区域 if (!SendMessage(LVM_GETSUBITEMRECT, (WPARAM)nRow, (LPARAM)rc)) return FALSE; // comctl32 太老会走到这里 return TRUE; }LVIR_BOUNDS和LVIR_LABEL的区别值得说一句前者包含图标和缩进后者只包含文本区域。做编辑框要覆盖整个格子所以用前者。第 0 列的坑是 comctl32 的既定行为文档里写得不显眼但实测确实返回整行——不截断的话双击第一列会看到一个横跨四列的编辑框。手写版本其实和上面那句SendMessage是一回事只是不走 MFC 的封装方便在_WIN32_IE定得低或者怀疑封装出错时对照排查。真机上如果LVM_GETSUBITEMRECT返回 FALSE八成是 comctl32 版本不够退回去检查 2.2 节的InitCommonControlsEx。3.3 把 CEdit 盖上去创建、定位、字体编辑框不要在每次编辑时 new 一个再 delete那是最容易漏内存的写法。整个控件只持有一个CEdit实例第一次编辑时创建之后只做MoveWindow和ShowWindow。父窗口设成列表控件自己这样编辑框的坐标系天然跟着列表走窗口移动、父窗口重绘都不用额外处理。// EditableListCtrl.cpp #define IDC_CELL_EDIT 3001 void CEditableListCtrl::StartEdit(int nRow, int nCol) { CRect rcCell; if (!GetCellRect(nRow, nCol, rcCell) || rcCell.IsRectEmpty()) return; EndEdit(TRUE); // 先收掉上一个防止两框并存 m_nEditRow nRow; m_nEditCol nCol; m_strOldText GetItemText(nRow, nCol); if (m_pEdit NULL) { m_pEdit new CCellEdit; m_pEdit-SetOwner(this); // 父窗口传 this编辑框才会被列表裁剪 if (!m_pEdit-Create(WS_CHILD | ES_AUTOHSCROLL | ES_LEFT, rcCell, this, IDC_CELL_EDIT)) { delete m_pEdit; m_pEdit NULL; return; } } // 字体必须显式设不设就是系统默认字体中文高度对不上 CFont* pFont GetFont(); m_pEdit-SetFont(pFont ! NULL ? pFont : CFont::FromHandle( (HFONT)::GetStockObject(DEFAULT_GUI_FONT))); rcCell.DeflateRect(1, 1); // 内缩 1px盖住网格线更整齐 m_pEdit-MoveWindow(rcCell); m_pEdit-SetWindowText(m_strOldText); m_pEdit-ShowWindow(SW_SHOW); m_pEdit-SetSel(0, -1); // 全选用户一打字就覆盖原值 m_pEdit-SetFocus(); }ES_AUTOHSCROLL不能少长文本靠它横向滚动否则编辑框里看到的是被截断的半截内容。DeflateRect(1, 1)让编辑框边框和网格线错开视觉上更服帖不内缩也能用就是边缘会压住网格线显得脏。还有一点SetFocus之后光标在编辑框里列表控件就失去了焦点LVS_SHOWSELALWAYS此时开始发挥作用——没有它选中行会变成灰色用户根本不知道自己正在改哪一行。3.4 提交与撤销三路事件归一到一个 EndEdit回车、Tab、Esc、点到别处导致焦点丢失这四件事最后都要走同一个函数否则四种路径四份逻辑迟早有一份写漏。工程的写法是一个EndEdit(BOOL bSave)兜底CancelEdit和CommitAndMove都只是它的薄封装。// EditableListCtrl.cpp void CEditableListCtrl::EndEdit(BOOL bSave) { if (m_pEdit NULL || !::IsWindow(m_pEdit-GetSafeHwnd())) return; if (m_nEditRow 0) return; m_bInCommit TRUE; // 防重入见第 5 章 int nRow m_nEditRow; int nCol m_nEditCol; m_nEditRow m_nEditCol -1; CString strNew; m_pEdit-GetWindowText(strNew); m_pEdit-ShowWindow(SW_HIDE); if (bSave strNew ! m_strOldText) { SetItemText(nRow, nCol, strNew); RedrawItems(nRow, nRow); // 不重绘会残留旧文本 UpdateWindow(); // 自定义消息通知视图行、列、旧值、新值 NMLISTEDIT nm; nm.hdr.hwndFrom GetSafeHwnd(); nm.hdr.idFrom GetDlgCtrlID(); nm.hdr.code NM_CELLEDIT_END; nm.nRow nRow; nm.nCol nCol; nm.strOld m_strOldText; nm.strNew strNew; GetParent()-SendMessage(WM_CELLEDIT_END, 0, (LPARAM)nm); } else { RedrawItems(nRow, nRow); // 取消也要重绘擦掉编辑框残留 } m_bInCommit FALSE; } void CEditableListCtrl::CancelEdit() { EndEdit(FALSE); SetFocus(); // 焦点还给列表键盘还能继续走 } void CEditableListCtrl::CommitAndMove(int nColDelta, int nRowDelta) { int nRow m_nEditRow, nCol m_nEditCol; EndEdit(TRUE); if (nRow 0) return; int nNextRow nRow nRowDelta; int nNextCol nCol nColDelta; CHeaderCtrl* pHeader GetHeaderCtrl(); if (pHeader NULL) return; // 越界就回绕别让用户按 Tab 到最后一格后卡死 if (nNextCol pHeader-GetItemCount()) { nNextCol 0; nNextRow; } if (nNextCol 0) { nNextCol pHeader-GetItemCount() - 1; nNextRow--; } if (nNextRow 0 nNextRow GetItemCount()) { SetItemState(nNextRow, LVIS_SELECTED | LVIS_FOCUSED, LVIS_SELECTED | LVIS_FOCUSED); EnsureVisible(nNextRow, FALSE); // 跨屏时必须滚动到可见 StartEdit(nNextRow, nNextCol); } }RedrawItems加UpdateWindow这个组合不能省。只调SetItemText的话列表控件会把自己的重绘排进消息队列而编辑框刚隐藏那一块区域在重绘到来之前是空白的用户看到的是“改完的字闪了一下才出现”。UpdateWindow强制立刻重绘体验上干脆很多。SendMessage而不是PostMessage是有意的视图收到消息后可能要立刻校验输入、甚至把非法值回滚这些动作必须在编辑状态彻底结束之前完成。用PostMessage的话消息还在队列里用户可能已经点到下一个格子了。4. 控件封装与事件处理CEdit 子类化、自定义通知和文档视图对接第 3 章把链路拉通了但还有三件事没解决回车在CEdit里默认是“叮”一声什么都不做Tab 会被对话框机制吃掉焦点丢失时提交会引发重入。这三件事都指向同一个手段——把CEdit子类化。4.1 为什么把编辑器塞进控件派生类而不是写在视图里最直观的写法是视图类里ON_WM_LBUTTONDBLCLK、ON_WM_VSCROLL、ON_WM_KILLFOCUS一把梭反正都能跑。但这么写有三个后患视图里要额外维护“当前编辑行/列/旧文本”三个成员滚动条消息是列表控件收到的视图拦不到只能靠反射或者子类化最要命的是第二张表加进来的时候所有这些都要复制一遍。把CEditableListCtrl做成派生类的收益就在这编辑状态是控件自己的私有数据滚动消息天然能收到谁想用就在自己的视图里放一个成员。视图那边只需要处理一条自定义通知剩下的完全不关心。代价是多两个文件、多点DECLARE_DYNAMIC值。// EditableListCtrl.h #define WM_CELLEDIT_END (WM_USER 120) // 视图 → 控件 的方向不用它 struct NMLISTEDIT { NMHDR hdr; int nRow; int nCol; CString strOld; CString strNew; }; class CEditableListCtrl : public CListCtrl { DECLARE_DYNAMIC(CEditableListCtrl) public: CEditableListCtrl(); virtual ~CEditableListCtrl(); BOOL GetCellText(int nRow, int nCol, CString str) const; BOOL SetCellText(int nRow, int nCol, LPCTSTR lpszText); void StartEdit(int nRow, int nCol); void EndEdit(BOOL bSave); void CancelEdit(); void CommitAndMove(int nColDelta, int nRowDelta); void OnEditorLostFocus(); // 给 CCellEdit 回调 protected: CCellEdit* m_pEdit; int m_nEditRow, m_nEditCol; CString m_strOldText; BOOL m_bInCommit; BOOL GetCellRect(int nRow, int nCol, CRect rc) const; afx_msg void OnLButtonDblClk(UINT nFlags, CPoint point); afx_msg void OnVScroll(UINT nSBCode, UINT nPos, CScrollBar* pBar); afx_msg void OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pBar); afx_msg void OnMouseWheel(UINT nFlags, short zDelta, CPoint pt); afx_msg void OnDestroy(); DECLARE_MESSAGE_MAP() };NMLISTEDIT的第一个成员必须是NMHDR这样视图那边可以按标准通知的写法走OnNotify统一分发也可以直接用ON_MESSAGE接WM_CELLEDIT_END。工程里选了后者因为WM_USER 120这个自定义消息号在本视图里独占用起来更直接。4.2 CCellEdit拦键盘、吃掉 Tab、避免重入CEdit默认对回车没反应单行编辑框会响一声系统提示音对 Tab 则是把焦点交给下一个控件——在表格编辑场景里这两个行为都不对。子类化之后在OnKeyDown里截住就行。// CellEdit.cpp IMPLEMENT_DYNAMIC(CCellEdit, CEdit) BEGIN_MESSAGE_MAP(CCellEdit, CEdit) ON_WM_KEYDOWN() ON_WM_KILLFOCUS() END_MESSAGE_MAP() void CCellEdit::OnKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags) { switch (nChar) { case VK_RETURN: if (m_pOwner) m_pOwner-CommitAndMove(0, 1); // 提交下移一行 return; // 不调基类避免提示音 case VK_TAB: if (m_pOwner) m_pOwner-CommitAndMove(1, 0); // 提交右移一列 return; case VK_ESCAPE: if (m_pOwner) m_pOwner-CancelEdit(); // 丢弃还原旧值 return; } CEdit::OnKeyDown(nChar, nRepCnt, nFlags); } void CCellEdit::OnKillFocus(CWnd* pNewWnd) { CEdit::OnKillFocus(pNewWnd); if (m_pOwner ! NULL) m_pOwner-OnEditorLostFocus(); // 统一出口内部有重入保护 }三个return的位置很关键。如果在VK_RETURN分支里忘了return基类CEdit::OnKeyDown还会处理一遍表现就是“提交了两次”或者“提交后又响一声”。VK_TAB同理基类会调GetNextDlgTabItem把焦点甩出去编辑框还没提交就失焦了。OnKillFocus里调OnEditorLostFocus而不是直接EndEdit(TRUE)是因为CommitAndMove内部会先EndEdit再SetFocus到列表这条路径上焦点会变两次第二次触发KillFocus时m_nEditRow已经是 -1直接EndEdit也能挡住但中间会多做一次GetWindowText。加一层回调语义更清楚void CEditableListCtrl::OnEditorLostFocus() { if (m_bInCommit) return; // 正在提交别插一脚 EndEdit(TRUE); }4.3 自定义通知把“某格改完了”干净地回传给视图SetItemText之后父窗口能收到的通知有限LVN_ITEMCHANGED主要在选中态和状态位变化时来指望它感知文本修改容易踩空。与其去猜不如自己发一条消息字段想带什么带什么。// TableEditView.cpp BEGIN_MESSAGE_MAP(CTableEditView, CView) ON_WM_CREATE() ON_WM_SIZE() ON_MESSAGE(WM_CELLEDIT_END, OnCellEditEnd) END_MESSAGE_MAP() LRESULT CTableEditView::OnCellEditEnd(WPARAM wParam, LPARAM lParam) { NMLISTEDIT* p (NMLISTEDIT*)lParam; if (p NULL) return 0; // 1) 业务校验数量列必须是正整数 if (p-nCol COL_QTY) { int nVal _ttoi(p-strNew); if (nVal 0) { AfxMessageBox(_T(数量必须是大于 0 的整数)); m_wndList.SetItemText(p-nRow, p-nCol, p-strOld); // 回滚 return 0; } } // 2) 写回文档文档负责脏标记和撤销栈 CTableEditDoc* pDoc GetDocument(); pDoc-SetCellValue(p-nRow, p-nCol, p-strNew); pDoc-SetModifiedFlag(TRUE); // 关窗口时才会提示保存 return 0; }注意lParam指向的是栈上的局部结构体SendMessage是同步调用视图处理完才返回所以指针有效。换成PostMessage就悬空了——这是很多人都踩过的坑改个函数名程序就随机崩。SetModifiedFlag(TRUE)那一行容易被忘。忘了的后果是关窗口不提示保存用户改了半天点叉直接没了血泪教训。4.4 与文档/视图对接改数据不重建表OnUpdate里最省事的写法是DeleteAllItems()然后全量重刷数据量小的时候无所谓几千行的时候每次编辑都闪一下体验很差。工程里用一个m_nRefreshing标志挡住回环只在列结构变化时才重建void CTableEditView::OnUpdate(CView* pSender, LPARAM lHint, CObject* pHint) { if (m_nRefreshing 0) return; // 自己触发的更新直接忽略 CTableEditDoc* pDoc GetDocument(); if (lHint HINT_COLUMNS_CHANGED) { m_wndList.DeleteAllItems(); FillAllRows(pDoc); // 结构变了才全量重建 } else { m_wndList.RefreshVisibleRows(pDoc); // 只回写可见行的文本 } }RefreshVisibleRows大致就是遍历GetTopIndex()到GetTopIndex() GetCountPerPage()之间的行逐个SetItemText。行数上千的时候这一招很有效因为它只碰屏幕上那二十来行其余的下次滚到了再刷。5. 排查清单编辑框错位、闪退、焦点乱跳的五种现场这套代码在几台机器上跑过之后问题基本都集中在下面五类。每一条我都按“现象—原因—解决”记下来照着对能省不少调试时间。5.1 现象编译报GetSubItemRect不是 CListCtrl 的成员原因几乎只有一个StdAfx.h里_WIN32_IE没定义或者定义在了#include afxwin.h之后。MFC 6 的afxcmn.h用预处理把这两个函数包了起来宏不到位就等于不存在。VC6 的工程设置里C/C → Preprocessor definitions那一栏也能加但工程选项和StdAfx.h两处都写反而容易打架统一放StdAfx.h最省事。解决把#define _WIN32_IE 0x0400挪到文件第一行#include全部放到它后面然后 Rebuild All。只做 Build 有时候增量编译不会重编StdAfx.h依赖的文件宏改了跟没改一样。5.2 现象双击第一列编辑框横跨整行原因在 3.2 节讲过——LVM_GETSUBITEMRECT对iSubItem 0加LVIR_BOUNDS的组合返回的是整行矩形不是第一列。这个行为在文档里描述得很含糊实测才看得出来。解决第 0 列走GetItemRect(nRow, rc, LVIR_BOUNDS)拿行矩形再把rc.right改成rc.left GetColumnWidth(0)。如果想更精细也可以把LVIR_BOUNDS换成LVIR_LABEL再加回缩进量但列宽版本更直观。5.3 现象一滚滚轮或者拖滚动条编辑框就悬在半空原因编辑框是列表控件的子窗口父窗口客户区原点一动子窗口不会自动跟着重定位。列表控件滚动时移动的是内部绘制内容不是窗口本身所以编辑框还停在原来的屏幕位置看起来就像“贴在表格上的一块补丁”。解决在派生类里拦WM_VSCROLL、WM_HSCROLL、WM_MOUSEWHEEL先EndEdit(TRUE)再交给基类void CEditableListCtrl::OnVScroll(UINT nSBCode, UINT nPos, CScrollBar* pBar) { EndEdit(TRUE); // 先收再滚 CListCtrl::OnVScroll(nSBCode, nPos, pBar); }OnMouseWheel的写法一样参数签名是(UINT nFlags, short zDelta, CPoint pt)。别只拦WM_VSCROLL就完事滚轮走的是另一条消息只拦一个的话鼠标滚轮照样出问题。5.4 现象改完一格后偶尔崩溃调用栈停在SetItemText里面原因重入。OnKillFocus里调EndEdit→EndEdit里SetItemText→ 列表重绘 → 某些情况下焦点再次变化 → 又进OnKillFocus→m_nEditRow已被改成 -1 但m_pEdit还在 → 取到非法行号。解决加m_bInCommit标志EndEdit进来先置 TRUE退出前置 FALSEOnEditorLostFocus第一行判断这个标志直接返回。另外EndEdit里取完窗口文本要立刻ShowWindow(SW_HIDE)让编辑框先消失再做写值动作顺序反了也会加重绘冲突。5.5 现象中文显示成方框或者编辑框比单元格高一截原因编辑框没设字体用的是系统默认 GUI 字体而列表控件可能被SetFont换成了宋体 9 号。两者字高不一样编辑框就会出现“文字偏上”或者“边框压住下一行”的观感。多显示器不同 DPI 的环境下更明显。解决StartEdit里统一m_pEdit-SetFont(GetFont())GetFont()返回 NULL 时退回DEFAULT_GUI_FONT。如果列表用了自定义字体记得CFont对象的生命周期要长于编辑框别在局部作用域里CreateFont然后让编辑框引用——那是标准的悬空句柄表现是文字随机变成乱码。6. 二次开发从单格编辑到列校验、虚表和大数据量提交这套骨架能跑之后真正的工作量在“往上加东西”。我一般的顺序是先加列级校验再考虑数据量大时的虚表改造。列级校验最简单的做法是把校验规则抽成一个小结构体数组按列索引查表别在OnCellEditEnd里堆if-elsestruct COL_RULE { int nCol; LPCTSTR lpszTip; BOOL (*pfnCheck)(LPCTSTR); }; static BOOL CheckPositive(LPCTSTR s) { return _ttoi(s) 0; } static BOOL CheckNotEmpty(LPCTSTR s) { return s ! NULL *s ! _T(\0); } static const COL_RULE g_Rules[] { { COL_NAME, _T(名称不能为空), CheckNotEmpty }, { COL_QTY, _T(数量必须是正整数), CheckPositive }, };查表命中就调函数指针没命中直接放行。好处是新增一列只加一行配置不用动主流程坏处是函数指针没法捕获上下文遇到“数量不能超过库存”这种要查库的规则就得换虚函数或者std::function——VC6 没std::function用抽象基类加new更实际。再往上是虚表。行数过万的时候InsertItem一行一行塞会明显卡顿改成LVS_OWNERDATA加LVN_GETDISPINFO只在系统要显示某行时才回填文本内存和速度都能接受。但虚表有个副作用SetItemText不再能改数据得改成“写回数据源 RedrawItems”第 3 章的EndEdit要动一处。改造前先确认数据源本身支持按行随机访问用CArray就行用链表就得先换容器。还有一个我踩过的坑批量粘贴。用户从 Excel 复制一片区域贴进来OnCellEditEnd会连着触发几十次每次都SendMessage回视图去做校验和SetModifiedFlag中间还夹着重绘请求卡得肉眼可见。后来改成编辑期间只往一个待提交队列里塞用PostMessage起一个合并处理一轮消息循环只刷一次界面才顺畅起来。从那以后我每次动这类表格编辑的代码都强制自己先在真机上把“双击—改字—滚轮—Tab—Esc—关窗口”这一串走一遍再去看内存。因为这套东西的问题从来不写在编译错误里它只在用户手里出现。希望帮到你。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
