简介：CGridCtrl_demo演示程序是一份面向Visual C++开发者的完整示例，重点展示MFC表格控件CGridCtrl与CMyODBC数据库访问类的结合用法。开发者在MFC应用中往往需要以网格形式展示、编辑数据库记录，这份代码将两者封装并串起从连接数据源、执行SQL查询、填充单元格到用户交互更新回数据库的典型流程。资源共36个文件，压缩包仅102KB，以头文件（.h）和源文件（.cpp）为主，配合对话框资源、项目工作区文件（.dsp/.dsw）及图标位图资源，适合在VC++6.0或更高版本中直接打开编译学习。已有274人学习，代码结构清晰，注释直接，可直接复用网格控件封装类与ODBC操作模块，也可用作开发数据管理界面的起点。对于想深入了解MFC控件扩展、ODBC数据库封装以及表格交互设计的开发者，这是一份实用的参考范例。除核心网格实现外，还包含单元格选区、行内编辑、拖放目标等辅助类，可以观察这些功能如何与数据库更新逻辑协同工作。
1. CGridCtrl demo 不是给你一个表格，是给你一套可编辑网格的骨架
CGridCtrl demo 最常被误读的地方在于：很多人以为拖进去一个控件、调用两行SetItemText就完事了，结果一运行发现单元格点不动、列头一排序就崩、数据一过万滚起来卡成幻灯片。实际上，CGridCtrl 的价值不在“显示表”，而在“把 MFC 的对话框变成一个能编辑、能排序、能自绘的 Excel 最小子集”。这个 demo 程序出现得如此频繁，恰恰是因为它把这条骨架上最难的三段——创建挂载、数据填充、交互状态管理——全部压缩在了一个可编译的工程里。本文适合正在维护 MFC 桌面程序、想把 CListCtrl 换掉、或者准备自己封装表格控件的开发者。接下来我会按“跑通 demo → 填数据 → 做交互 → 查坑”的顺序把它拆开讲，所有代码都是可以直接抄进工程的最小版本。
2. 先把 CGridCtrl 挂进 MFC 对话框：demo 工程里最基础的三个动作
2.1 CGridCtrl 的类结构：为什么它由 CWnd 派生而不是 CListCtrl
CGridCtrl 核心类是继承自CWnd的窗口控件，不是CListCtrl的子类。这一点很关键：它没有复用系统列表控件的虚拟窗口，而是在自己的WM_PAINT里自绘所有单元格。整个类的内部由两个层次构成——最外层是CGridCtrl，负责响应鼠标键盘消息、管理行高列宽；内层是CGridCell，负责单个格子的文本、颜色、图标和编辑状态。这个分工决定了你在用 demo 的时候看到的所有操作，其实都是“坐标命中测试 + 消息转发到单元格”。
理解这一点，你才知道 demo 里能学到的第一个技巧：不要想着去改CGridCtrl继承体系，而是利用它提供的消息接口。比如你要捕获双击：拦截NM_CLICK或重写Virtual OnGridEndEdit并不会影响整体绘制逻辑。我一般会在对话框类里直接操作m_grid这个成员，而不是派生新控件，这样修改范围最小。
2.2 解压 CGridCtrl_demo.rar 后，把 source 文件集成到你的工程
CGridCtrl_demo.rar解压后你会看到典型的 CodeProject 时代工程结构：源代码目录里包含GridCtrl.h/.cpp、GridCell.h/.cpp、GridCellBase.h/.cpp，以及 InPlaceEdit 相关的几个文件。把这些文件全部拖进你的 MFC 工程的 Source 目录，然后在对话框头文件里声明控件成员：
// MainDlg.h #pragma once #include "GridCtrl.h" class CMainDlg : public CDialogEx { public: CGridCtrl m_grid; // CGridCtrl 控件成员，注意不是指针 };在OnInitDialog中创建并初始化它：
BOOL CMainDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 创建一个矩形区域，先占住对话框位置 CRect rc; GetDlgItem(IDC_PLACEHOLDER)->GetWindowRect(&rc); ScreenToClient(&rc); // 创建控件，风格指定为可见 + 带边框 m_grid.Create(rc, this, IDC_GRIDCTRL, WS_CHILD | WS_VISIBLE | WS_BORDER); m_grid.SetRowCount(20); m_grid.SetColumnCount(5); m_grid.SetFixedRowCount(1); // 固定第一行作为列头 m_grid.SetFixedColumnCount(1); // 固定第一列，形成行头 m_grid.SetColumnWidth(0, 80); m_grid.SetColumnWidth(1, 200); return TRUE; }这段代码的要点有三个：Create时传的是this作为父窗口，这是与其他控件不同的地方，它要求父窗口必须支持反射消息；SetFixedRowCount必须在设置行数之后调，否则列头区域计算会错；IDC_PLACEHOLDER可以用一个真实的Static Text控件占位，也可以直接写死CRect(10, 10, 800, 400)。如果工程是_UNICODE编译且你在旧版本代码中看到TCHAR数组，注意字符集一致性问题，否则编译会报C2664之类的转换错误。
2.3 初始化网格必调的三个参数：行数、列数、固定行列
很多 demo 的初始化代码会把SetGridLines、EnableDragAndDrop和SetEditable一股脑全写上，但真正决定网格“能不能用”的只有下面这一组参数。
| 方法 | 作用 | 常见陷阱 |
|---|---|---|
SetRowCount(n) | 设置总行数，含固定行 | 在设置列宽之后再调，会按默认行高重建行，导致前面的列宽丢失 |
SetColumnCount(n) | 设置总列数，含固定列 | 不要在SetFixedColumnCount之前调用基于列号的操作 |
SetFixedRowCount(1) | 设定顶部固定区域 | 固定行会参与绘制但不会进入编辑状态 |
SetColumnWidth(col, w) | 设定列宽，像素单位 | 中途修改该列内容不会自动重算宽度 |
SetEditable(TRUE) | 允许编辑所有单元格 | 局部只读需要用SetItemState单独指定 |
填充数据之前我把m_grid.SetRedraw(FALSE)调用加上，因为每次SetItemText都会触发一次局部刷新，几千行数据时肉眼可见地闪烁。全部填完后再SetRedraw(TRUE)并Invalidate()。这是 demo 里最不起眼、但对体验提升最大的一句话，后面所有大数据量操作都应该沿用这个模式。
提示：CGridCtrl 的原版 demo 工程默认是 MFC 静态链接。如果你改用动态链接运行库，请保证编译选项一致，否则会在运行时出现奇怪的句柄释放断言。
3. 填充数据之前先想清楚：表格和业务数据的同步模型
3.1 定义一个数据行结构，不要让网格成为唯一数据源
常见错误写法是：程序启动后用一堆SetItemText把数据写进网格，用户编辑完单元格后，再从网格逐行读出来。这在 demo 里能跑，但一旦涉及排序、筛选或者撤销，你会立刻陷入“网格里的行号和业务数据行号对不上”的泥潭。
我建议的做法是：在对话框类里定义一个RowData结构，网格只负责显示，业务逻辑只操作这个结构数组。这样“从数据源到网格”是单向映射，排序和编辑后同步回来即可。
struct FileRowData { CString name; CString path; CString modifyTime; ULONGLONG fileSize; }; // 对话框成员 std::vector<FileRowData> m_rows;填充时循环m_rows写入网格：
void CMainDlg::RefreshGridFromData() { m_grid.SetRedraw(FALSE); m_grid.SetRowCount((int)m_rows.size() + 1); // +1 是固定列头行 for (size_t i = 0; i < m_rows.size(); i++) { int row = (int)i + 1; // 从第 1 行开始，第 0 行留给列头 m_grid.SetItemText(row, 0, m_rows[i].name); m_grid.SetItemText(row, 1, m_rows[i].path); m_grid.SetItemText(row, 2, m_rows[i].modifyTime); // 文件大小转成可读的 MB 字符串 CString sizeStr; sizeStr.Format(L"%.2f MB", m_rows[i].fileSize / 1048576.0); m_grid.SetItemText(row, 3, sizeStr); } m_grid.SetRedraw(TRUE); m_grid.Invalidate(); }注意这里SetRowCount的+1：如果数据有 100 行，固定行占 1 行，网格总行数就是 101。很多第一次抄 demo 代码的人会在后续点击列头排序时发现索引越界，多半就是这里少了固定行偏移。SetItemText的第一个参数始终是网格坐标，而不是数据源下标。
3.2 列头与单元格样式：SetItemFormat 覆盖面板，不要逐格重绘
demo 里的列头通常是要做背景色和字体区分的。CGridCtrl 提供了一套缺省格式面板，你可以在初始化时统一配置，而不是对每个单元格单独调样式。
// 设置列头文字居中，背景灰色 m_grid.SetItemFormat(0, 0, DT_CENTER | DT_VCENTER | DT_SINGLELINE); m_grid.SetItemBkColor(0, 0, RGB(240, 240, 245));如果表格有大量行需要做斑马纹，可以直接在填充循环里判断行号奇偶性：
for (int row = 1; row < m_grid.GetRowCount(); row++) { if (row % 2 == 0) m_grid.SetItemBkColor(row, 0, RGB(255, 255, 255)); else m_grid.SetItemBkColor(row, 0, RGB(245, 248, 252)); }性能上要注意：SetItemBkColor对每个单元格都会触发一次InvalidateRect，所以必须把这段代码放在SetRedraw(FALSE)和SetRedraw(TRUE)之间。超过 5000 行时建议只在滚动后按可见区刷新，或者直接用后面第 4 章的虚拟列表模式。
3.3 从 demo 程序到可编辑网格：前三步让单元格进入编辑态
你可能会遇到一个奇怪现象：默认 demo 里双击单元格能编辑，但你的工程不行。这是因为原版 CGridCtrl 在创建时如果父窗口没有处理WM_NOTIFY反射，EditCell的触发就会被吞掉。首先要确认SetEditable(TRUE)被调用，然后处理列头行禁止编辑：
m_grid.SetEditable(TRUE); // 禁止固定行进入编辑模式 for (int col = 0; col < m_grid.GetColumnCount(); col++) m_grid.SetItemState(0, col, m_grid.GetItemState(0, col) | GVIS_READONLY);GVIS_READONLY是 CGridCtrl 内部的单元格状态标志，与CGridCellBase的编辑逻辑挂钩。这个标志位在你希望“某些列只读”时同样适用。例如path列不想让用户改动，循环里多判断字符串等于那一列即可。别忘了控件默认的编辑触发方式是“单击选中，再次单击或回车进入编辑”。如果你的用户体验目标是“获得焦点即编辑”，需要在派生类里重写OnGetDispInfo之后强制调用EditCell，veto 掉第一个单击定时器。
提示：每次单元格修改结束后，网格会发送
GVN_ENDLABELEDIT通知。demo 里最常见的改写点就在这个通知里，你需要在这里把新文本写回m_rows对应的结构字段，否则排序时数据源和网格立刻失去同步。
4. 让 demo 更像正经产品：排序、虚拟模式与自绘边界
4.1 点击列头排序：先排数据源，再整表重建，避免破坏坐标状态
CGridCtrl 自带一套排序机制，调用SetSortColumn(col)并实现派生类的CompareItems虚函数即可。但我在实际工程里更喜欢绕开它：直接用std::sort排业务数据m_rows，然后RefreshGridFromData()。理由很朴素——demo 的CompareItems里写列号和比较逻辑，一旦列头被拖拽换位，列号和字段名的映射就乱了。
#include <algorithm> void CMainDlg::SortByColumn(int col, bool ascending) { std::sort(m_rows.begin(), m_rows.end(), [col](const FileRowData& a, const FileRowData& b) { if (col == 0) return a.name.CompareNoCase(b.name) < 0; if (col == 3) return a.fileSize < b.fileSize; // 按数值而非显示字符串排序 return a.modifyTime.Compare(b.modifyTime) < 0; }); if (!ascending) std::reverse(m_rows.begin(), m_rows.end()); RefreshGridFromData(); }注意这里对“文件大小”列排序，必须用ULONGLONG的比较而不是字符串比较。否则“1.05 MB”和“1.5 MB”会按字符串'0' < '5'的规则排出错误结果。排序完记住把列头的三角标记画出来：m_grid.SetSortColumn(col, ascending)。这两个调用一前一后完成，视觉和逻辑都对齐。
4.2 超过一万条记录，用 SetVirtualMode 而不是继续逐行填
如果你的 list 数据量上了十万级，逐行SetItemText会在启动和切数据源时卡上几百毫秒。CGridCtrl 从版本 3.0 左右开始支持虚拟模式，运行时不保存数据，只保存类型，真实数据在你重写的虚函数里返回。这是一种适合只读浏览场景的模式。
void CMainDlg::InitVirtualGrid() { m_grid.SetVirtualMode(TRUE); m_grid.SetRowCount(100000); m_grid.SetColumnCount(4); m_grid.SetFixedRowCount(1); m_grid.SetRedraw(FALSE); // 填充列头名称 m_grid.SetItemText(0, 0, L"文件名"); m_grid.SetItemText(0, 1, L"路径"); m_grid.SetItemText(0, 2, L"修改时间"); m_grid.SetItemText(0, 3, L"大小"); m_grid.SetRedraw(TRUE); m_grid.Invalidate(); } CString CMainDlg::OnVirtualCellText(int nRow, int nCol) const { if (nRow == 0) return L""; // 列头由 SetItemText 设置 const FileRowData& rd = m_rows[nRow - 1]; switch (nCol) { case 0: return rd.name; case 1: return rd.path; case 2: return rd.modifyTime; case 3: { CString sizeStr; sizeStr.Format(L"%.2f MB", rd.fileSize / 1048576.0); return sizeStr; } } return L""; }OnVirtualCellText只负责返回文本，数据的真正所有权仍然属于m_rows。虚拟模式下排序变得无比轻松——你照样用std::sort排m_rows，随后调用一次m_grid.Invalidate()即可；因为网格在滚动和刷新时会重新向虚拟数据源取值。
4.3 自绘的边界：能用 SetItemFormat 解决的，别重写 DrawCell
CGridCtrl 的扩展点很多，最激进的是从CGridCtrl派生并重写DrawCell这类虚函数。以我的经验，除非你要做那种界面夸张的仪表盘，否则不值得。让单元格显示状态点、进度条、内嵌图标，绝大多数都能用现有的格式面板完成：设置SetItemFormat为DT_CENTER、前景色用SetItemTextColor、背景色用SetItemBkColor。只有当你需要画“单元格右下角带一个小红点”这种非常规内容时，才去继承和重绘。
重绘时注意菱形坐标：CGridCtrl 内部会先计算单元格矩形再调用绘制函数，DC的原点在控件左上角，不是窗口左上角。直接在重绘函数里写rc.left + rc.right / 2这种常见错误，会让图形在横向滚动时错位。正确写法是：
CPoint center((rc.left + rc.right) / 2, (rc.top + rc.bottom) / 2);自绘代码里不要保存CDC指针跨函数使用，因为多显示器 DPI 切换会导致设备上下文失效。这也是 demo 里覆盖较少的场景，遇到图形闪烁时优先怀疑BeginPaint/EndPaint配对。
5. 排查 CGridCtrl demo 运行期的五个高频故障与一个性能自测技巧
5.1 从黑屏到崩溃：CGridCtrl demo 运行期故障速查表
| 现象 | 直接原因 | 处理方式 |
|---|---|---|
| 网格区域空白，无任何边框 | Create失败或父窗口WS_CLIPCHILDREN未设置 | 检查返回值，在OnParentNotify中确认 IDC 不冲突 |
| 输入中文显示乱码 | 工程字符集为Multi-Byte，代码里使用了L""字符串 | 统一使用_T()宏或全部转Unicode字符集 |
| 双击编辑无反应 | CGridCtrl的消息反射未被父窗口处理 | 重写父类OnNotify，调用ReflectLastMsg |
| 点击列头崩溃 | 排序回调中访问了空的CGridCell | 在CompareItems里先用GetItem判断非空 |
| 表格行数过多时拖动滚动条卡死 | 每行都触发了InvalidateRect | 改用SetVirtualMode(TRUE)或SetRedraw(FALSE)批量操作 |
遇到黑屏不要急着改代码，先用 Spy++ 确认窗口是否正确创建；接着查看输出窗口有没有Assertion Failed。CGridCtrl 原版对断言很严格，行号越界会在调试运行时立刻弹出，这反而是好事，能帮你快速定位行列偏移的 bug。
5.2 一把尺子验证：填充耗时与滚动帧率的可复现度量
优化前先量化。下面这个函数用QueryPerformanceCounter测量“从数据源到网格填充完毕”的耗时，精确到毫秒，并在标题栏显示帧率基线：
void CMainDlg::MeasureFillPerformance() { LARGE_INTEGER freq, start, end; QueryPerformanceFrequency(&freq); std::vector<FileRowData> testData; for (int i = 0; i < 10000; i++) { FileRowData rd; rd.name.Format(L"File_%06d", i); rd.path.Format(L"C:\\data\\%06d.bin", i); rd.modifyTime = L"2024-01-01 00:00:00"; rd.fileSize = i * 1024; testData.push_back(rd); } QueryPerformanceCounter(&start); // 假设 m_rows = testData，然后调用 RefreshGridFromData() m_rows = testData; RefreshGridFromData(); QueryPerformanceCounter(&end); double elapsedMs = (end.QuadPart - start.QuadPart) * 1000.0 / freq.QuadPart; SetWindowText(L"CGridCtrl demo - Fill Time: " + FormatDoubleToCString(elapsedMs) + L" ms"); }10 万行数据在普通机器上，逐行填充通常处于 200 到 600 毫秒区间；开启虚拟模式后，同样的数据量填充耗时会掉到接近 0，因为没有任何单元格数据被写入。之后你可以用IsRowVisible和GetTopRow()判断滚动性能，核心观测指标是单次滚动回调耗时是否 > 16 ms。超过这个值就需要考虑缓存行高计算结果或减少列数。把这段代码放在初始化末尾，作为每次改动后的回归基线，比肉眼感觉可靠得多。
提示：如果调试运行时发现填充耗时有极大抖动，先排除杀毒软件实时扫描和性能监视器干扰；再用任务管理器锁定 CPU 频率，避免睿频造成测量误差。
本文还有配套的精品资源，点击获取
