简介：本资源是一份面向VC++初学者与MFC开发者的实用控件教程，聚焦DataGrid网格控件在桌面应用中的核心用法，解决数据展示、界面控制与格式化呈现等典型开发痛点。文档以对话框工程为载体，系统讲解如何通过ADO连接Access数据库并绑定Recordset显示查询结果，支持列宽动态调整、数值百分比格式化（如0.0%）、多行高度设置及HeadClick消息驱动的点击排序等关键功能，配套代码完整、注释清晰，并附VC6.0+WinXP环境实测截图与工程说明。资源为单个226KB Word文档（.doc），内容涵盖控件插入、类封装原理（CDataGrid/CColumns/CColumn）、VB与VC调用差异提示及源码获取方式，结构由浅入深，兼顾原理理解与即插即用。目前已有849人学习下载，适合希望快速掌握MFC原生网格控件实战技巧的中初级开发者。
1. MFC DataGrid 控件不是“过时摆设”：它仍是 Win32 桌面数据展示的稳定压舱石，尤其适合维护型项目、工业 HMI 和轻量级数据库前端
很多人一看到 MFC 就皱眉，觉得是“古董级技术”，DataGrid 更被当成 VB6 时代的遗老。但现实是：某高校实验室的设备监控系统、某公司十年未重构的产线数据录入终端、某跨平台系统中 Windows 端的本地配置管理模块——它们至今仍在用 MFC + DataGrid 控件跑得稳如泰山。这不是怀旧，而是权衡：当你的目标平台明确锁定 Windows 桌面（Win7/Win10/Win11），当你的数据源是 Access、SQL Server LocalDB 或 SQLite（通过 OLE DB 封装），当你需要快速交付一个带排序、列宽拖拽、单元格格式化、双击编辑能力的表格界面，且不希望引入 Qt 的庞大依赖或 C# WinForms 的 .NET 运行时绑定——DataGrid 就不是备选，而是最优解。它不炫技，但极可靠；它不抽象，但接口直给；它不跨平台，但对 Windows API 和 COM 的贴合度，是任何后来者都难以复刻的深度。本文不讲“为什么不用 WPF”，只聚焦一件事：如何让这个被低估的控件，在你手里的 VC6.0 或 VS2019（MFC 兼容模式）工程里，真正干活、少翻车、能维护。
2. DataGrid 控件接入全流程：从 ActiveX 插入到数据源绑定，一步不能跳过的 COM 初始化链
2.1 插入控件与类封装：为什么必须选 CDataGrid、CColumns、CColumn 而非全量导入？
在对话框资源编辑器中插入 ActiveX 控件时，选择 “Microsoft DataGrid Control, version 6.0” 是第一步。但关键在第二步：ClassWizard（VC6）或 “Add Class from Typelib”（VS2019）生成封装类时，绝不能勾选全部接口。原文图2只选三个类，这是血泪经验。CDataGrid 是主控件类，封装了 SetRefDataSource、GetColumns 等核心方法；CColumns 是列集合类，提供 GetItem、get_Count；CColumn 是单列类，承载 SetWidth、SetNumberFormat、SetDataFormat 等格式控制。若误选 IUnknown、_DataGridEvents 等底层 COM 接口类，会导致编译时出现大量error C2599: reference to 'IUnknown' is ambiguous—— 因为 MFC 自身的 AFXWIN.H 和 ole2.h 都定义了 IUnknown，而封装类会生成重复声明。正确做法是：仅导入类型库中明确标注为 “DataGrid”、“Columns”、“Column” 的三类，其余一律忽略。生成后，头文件中应只含#include "DataGrid.h"、"Columns.h"、"Column.h"，无其他 COM 接口头。
2.2 数据源绑定：Recordset 必须是 _RecordsetPtr 类型，且需显式 AddRef
原文代码中m_ctrlDG.SetRefDataSource((LPUNKNOWN)m_Rs.GetRecordset())看似简洁，实则埋雷。CADORecordset::GetRecordset()返回的是_RecordsetPtr智能指针，其内部已做引用计数管理；而SetRefDataSource要求传入IUnknown*，需调用GetInterfacePtr()获取裸指针，并手动AddRef()，否则控件在后续重绘或刷新时可能因对象提前释放而崩溃。正确写法如下：
// 正确：获取裸指针并 AddRef，确保生命周期由 DataGrid 控件托管 _RecordsetPtr pRs = m_Rs.GetRecordset(); if (pRs != nullptr) { IUnknown* pUnk = pRs.GetInterfacePtr(); if (pUnk != nullptr) { pUnk->AddRef(); // 关键！告诉 COM：DataGrid 现在持有此对象 m_ctrlDG.SetRefDataSource(pUnk); } }提示：
SetRefDataSource中的 “Ref” 即指 “Reference”，它不会复制数据，而是接管 Recordset 的 COM 引用计数。若忘记AddRef()，控件内部调用Release()后，Recordset 对象即被销毁，后续任何操作（如滚动、排序）都会触发访问违规。
2.3 数据库连接封装：CADODatabase 与 CADORecordset 的初始化顺序不可逆
ADO 封装类的使用有严格时序。CADODatabase必须先Open()成功，再将指针传给CADORecordset::SetDatabase()；CADORecordset的Open()必须在SetDatabase()之后调用，且 SQL 字符串必须是 Unicode（_T("select * from test")），否则在中文路径或字段名下会返回空记录集。常见错误是把m_Rs.Open()写在m_DBCn.Open()之前，导致m_Rs内部数据库句柄为空，Open()直接失败但无明显报错。验证方法是在Open()后立即检查：
HRESULT hr = m_Rs.Open(_T("select * from test")); if (FAILED(hr)) { AfxMessageBox(_T("查询失败，错误码：") + CString::Format(_T("0x%08X"), hr)); return; } long nCount = 0; m_Rs.GetRecordCount(&nCount); // 注意：Access Jet 引擎下此值可能为 -1，需用 MoveFirst/MoveNext 计数 if (nCount == 0 && m_Rs.GetEOF()) { AfxMessageBox(_T("数据集为空，请检查表名和字段是否存在")); }2.4 控件关联：DoDataExchange 中的 DDX_Control 必须与资源 ID 严格一致
在对话框类的DoDataExchange(CDataExchange* pDX)函数中，必须添加：
DDX_Control(pDX, IDC_DATAGRID1, m_ctrlDG); // IDC_DATAGRID1 是你在资源编辑器中为控件设置的ID若 ID 写错（如写成IDC_GRID），或未添加此行，m_ctrlDG将始终为 NULL，所有后续调用（GetColumns()、SetRefDataSource()）均无效，且无编译错误，只在运行时静默失败。这是新手最高频的“找不到控件”问题。验证方法：在OnInitDialog()中加断点，观察m_ctrlDG.m_hWnd是否为非零值。
3. 列控制与格式化：CColumns/CColumn 的真实能力边界与参数陷阱
3.1 列宽动态调整：SetWidth 单位是“缇（Twip）”，不是像素
CColumn::SetWidth(fWidth)的参数fWidth单位是缇（Twip），1 缇 = 1/20 磅 = 1/1440 英寸 ≈ 0.0176 mm。这意味着col.SetWidth(1440)才约等于 1 英寸宽（Windows 默认 DPI 下约 96 像素）。若直接传像素值（如col.SetWidth(100)），列宽会窄得看不见。正确换算公式为：
// 将像素 px 转为缇：px * 1440 / GetDeviceCaps(hDC, LOGPIXELSX) CDC* pDC = GetDC(); int nTwipsPerInch = GetDeviceCaps(pDC->GetSafeHdc(), LOGPIXELSX) * 20; // 20 twips per point ReleaseDC(pDC); double fTwips = 100.0 * nTwipsPerInch / 96.0; // 假设设计目标为 100 像素宽 col.SetWidth(static_cast<long>(fTwips));更实用的做法是：先用GetColumnWidth()读取当前宽度，再按比例缩放。例如自动适应内容：
CColumns cols = m_ctrlDG.GetColumns(); long nColCount = cols.get_Count(); for (long i = 0; i < nColCount; i++) { VARIANT vt; vt.vt = VT_I4; vt.lVal = i; CColumn col = cols.GetItem(vt); long nCurrWidth = col.GetWidth(); // 简单策略：设为 1500 缇（约 105 像素） col.SetWidth(1500); }3.2 数字格式化：SetNumberFormat 的字符串语法与区域设置强相关
col.SetNumberFormat(_T("0.0%"))能显示百分数，但前提是系统区域设置中“百分号”符号为%。若用户系统设为德语（%显示为Prozent），此格式将失效，显示为原始数字。安全做法是使用标准数字格式字符串，并避免依赖本地化符号：
// 安全：使用通用格式，不依赖本地符号 col.SetNumberFormat(_T("0.00")); // 两位小数 col.SetNumberFormat(_T("#,##0.00")); // 千分位+两位小数 col.SetNumberFormat(_T("0.00E+00")); // 科学计数法 // 百分数：用小数乘100后格式化，而非依赖 % 符号 // 在数据源层处理：SELECT field*100 AS pct_field FROM table // 然后对 pct_field 列设格式：col.SetNumberFormat(_T("0.00"));注意：
SetNumberFormat仅影响显示，不改变底层数据类型。若 Recordset 中字段是adDouble，格式化后仍可正常参与计算；若字段是adVarChar，则格式化无效，需先在 SQL 中CAST(field AS DOUBLE)。
3.3 文本对齐与字体：CColumn 不提供 SetAlignment，需用 SetCellFont
CColumn类没有SetAlignment方法，文本对齐需通过SetCellFont设置字体对象的lfEscapement和lfOrientation实现，但这过于复杂。实际工程中，对齐控制应在 Recordset 层完成：在 SQL 查询中为每列指定别名并用CAST或CONVERT统一类型，再在CDataGrid的ColumnHeaders属性中设置标题对齐，单元格内容对齐则由CDataGrid::SetRowHeight和SetFixedRowHeight间接影响。更直接的方法是响应WM_DRAWITEM消息自绘，但已超出 DataGrid 原生能力范围。
3.4 多行显示：SetRowHeight 影响全局，但需配合 Column.WrapText
m_ctrlDG.SetRowHeight(20)仅设置行高，若列内容超长，默认不换行。必须同时启用列的自动换行：
CColumns cols = m_ctrlDG.GetColumns(); VARIANT vt; vt.vt = VT_I4; vt.lVal = 0; // 第0列 CColumn col = cols.GetItem(vt); col.put_WrapText(TRUE); // 关键：允许文本换行 m_ctrlDG.SetRowHeight(30); // 行高需足够容纳多行若WrapText为 FALSE，增大SetRowHeight仅增加行间距，内容仍被截断。
4. 避坑：DataGrid 开发中五个高频翻车现场与硬核解法
4.1 现象：控件显示空白，调试发现m_ctrlDG.m_hWnd为 0
原因：DDX_Control未正确关联，或控件资源 ID 在.rc文件中被意外删除，或对话框模板未保存导致资源 ID 错位。
解决：在OnInitDialog()开头加ASSERT(m_ctrlDG.GetSafeHwnd() != NULL)；若断言失败，打开资源视图，右键 DataGrid 控件 → Properties → 查看 ID 是否与代码中IDC_DATAGRID1一致；若不一致，双击控件修改 ID 并重新生成。
4.2 现象：SetRefDataSource后表格有表头无数据，GetRecordCount()返回 -1
原因：Access 数据库路径含中文或空格，Jet OLE DB Provider 解析失败；或 Recordset 打开时未指定游标类型（adOpenStatic）和锁类型（adLockReadOnly），导致只读结果集无法被 DataGrid 识别。
解决：连接字符串强制使用短路径（GetShortPathName()），并显式指定游标：
m_Rs.Open(_T("select * from test"), vtMissing, adOpenStatic, // 关键 adLockReadOnly, // 关键 adCmdText);4.3 现象：列宽拖拽后，程序重启又恢复默认，SetWidth不生效
原因：SetWidth只在运行时生效，未持久化。DataGrid 不自动保存列宽设置。
解决：在对话框OnDestroy()中遍历列，将GetWidth()值写入注册表或 INI 文件；在OnInitDialog()中读取并SetWidth()。示例：
// 保存 CWinApp* pApp = AfxGetApp(); CColumns cols = m_ctrlDG.GetColumns(); for (long i = 0; i < cols.get_Count(); i++) { VARIANT vt; vt.vt = VT_I4; vt.lVal = i; long w = cols.GetItem(vt).GetWidth(); pApp->WriteProfileInt(_T("DataGrid"), CString(_T("ColWidth_")) + CString::Format(_T("%ld"), i), w); } // 加载 for (long i = 0; i < cols.get_Count(); i++) { CString key = CString(_T("ColWidth_")) + CString::Format(_T("%ld"), i); long w = pApp->GetProfileInt(_T("DataGrid"), key, 1440); // 默认1440缇 VARIANT vt; vt.vt = VT_I4; vt.lVal = i; cols.GetItem(vt).SetWidth(w); }4.4 现象：双击单元格无法编辑，或编辑后数据不回写到数据库
原因：DataGrid 默认只读；且 ADO Recordset 若以adLockReadOnly打开，则无法更新。
解决：设置m_ctrlDG.SetAllowUpdate(TRUE)；Recordset 必须用adLockOptimistic打开，并确保 SQL 查询包含主键（否则 ADO 不知更新哪行）：
m_Rs.Open(_T("select id, name, value from test"), vtMissing, adOpenKeyset, // 支持更新 adLockOptimistic, // 关键 adCmdText); m_ctrlDG.SetAllowUpdate(TRUE);4.5 现象：HeadClick 排序后，数据错乱，或点击标题无反应
原因：未正确处理NM_CLICK消息，或未重载OnNotify并过滤NM_CLICK的hdr.idFrom；或排序逻辑未重建 Recordset，仅在内存排序，导致与数据库状态脱节。
解决：在对话框类中添加消息映射ON_NOTIFY(NM_CLICK, IDC_DATAGRID1, &CMyDlg::OnHeadClick)，并在OnHeadClick中：
void CMyDlg::OnHeadClick(NMHDR *pNMHDR, LRESULT *pResult) { NMCLICK* pNMClick = reinterpret_cast<NMCLICK*>(pNMHDR); // 判断是否点击标题栏（y坐标小于固定行高） CRect rcFixed; m_ctrlDG.GetFixedRowRect(&rcFixed); if (pNMClick->pt.y < rcFixed.bottom) { // 获取点击列索引 long nCol = m_ctrlDG.GetColContainingPoint(pNMClick->pt.x, pNMClick->pt.y); // 重建 Recordset：ORDER BY 对应字段 CString strSQL = _T("select * from test ORDER BY "); strSQL += GetColumnName(nCol); // 需自行实现字段名映射 m_Rs.Close(); m_Rs.Open(strSQL, ...); m_ctrlDG.SetRefDataSource(...); // 重新绑定 } *pResult = 0; }5. HeadClick 排序实战：从消息捕获到 SQL 重建的完整闭环
5.1 消息映射与标题栏判定：为什么不能只靠 NM_CLICK？
NM_CLICK消息在用户点击任意位置（包括数据行）时都会触发，但 HeadClick 仅需响应标题栏点击。DataGrid 本身不提供HDN_ITEMCLICK类似消息，必须手动判断点击坐标是否落在固定行（Fixed Row）内。固定行高度由GetFixedRowHeight()获取，但更可靠的是调用GetFixedRowRect()获取矩形区域：
void CMyDlg::OnHeadClick(NMHDR *pNMHDR, LRESULT *pResult) { NMCLICK* pNMClick = (NMCLICK*)pNMHDR; // 获取固定行（标题栏）的屏幕坐标矩形 CRect rcFixed; m_ctrlDG.GetFixedRowRect(&rcFixed); // 将点击坐标转换为控件客户区坐标 CPoint pt = pNMClick->pt; ScreenToClient(&pt); // 判定：点击点 y 坐标是否在固定行内 if (pt.y >= rcFixed.top && pt.y <= rcFixed.bottom) { // 是标题栏点击，继续处理 OnHeaderClicked(pt.x, pt.y); } *pResult = 0; }5.2 列索引解析：GetColContainingPoint 的精度陷阱与容错
m_ctrlDG.GetColContainingPoint(x, y)返回列索引，但其 x 坐标是相对于控件左上角的像素值，而GetFixedRowRect()返回的是屏幕坐标。必须先ScreenToClient()转换，否则坐标系错位导致列索引错误。此外，该函数在列宽极窄（<5 像素）或鼠标点击列分隔线时可能返回 -1。需加容错：
void CMyDlg::OnHeaderClicked(int x, int y) { long nColIndex = m_ctrlDG.GetColContainingPoint(x, y); if (nColIndex < 0 || nColIndex >= m_ctrlDG.GetColumns().get_Count()) { // 点击位置无效，尝试取最邻近列 nColIndex = max(0L, min(nColIndex, m_ctrlDG.GetColumns().get_Count() - 1)); } // 获取该列对应的字段名（关键！） CString strFieldName = GetFieldNameByColumnIndex(nColIndex); if (strFieldName.IsEmpty()) return; // 构建排序 SQL CString strSQL; if (m_bSortAscending) { strSQL.Format(_T("SELECT * FROM test ORDER BY %s ASC"), strFieldName); m_bSortAscending = FALSE; } else { strSQL.Format(_T("SELECT * FROM test ORDER BY %s DESC"), strFieldName); m_bSortAscending = TRUE; } // 重建 Recordset 并重绑定 RebindDataSource(strSQL); }5.3 字段名映射表：安全映射列索引到 SQL 字段名的两种方案
DataGrid 列顺序与 SQL SELECT 子句字段顺序严格一致，但若 SQL 为SELECT name, age, id FROM test，则第0列对应name，第1列对应age。硬编码映射易出错。推荐两种方案：
方案一：运行时解析 Recordset 字段（推荐）
在RebindDataSource前，从当前 Recordset 获取字段名：
CString CMyDlg::GetFieldNameByColumnIndex(long nColIndex) { _RecordsetPtr pRs = m_Rs.GetRecordset(); if (pRs == nullptr) return _T(""); FieldsPtr pFields = pRs->GetFields(); if (pFields == nullptr || pFields->GetCount() <= nColIndex) return _T(""); FieldPtr pField = pFields->GetItem(nColIndex); if (pField == nullptr) return _T(""); return (LPCTSTR)_bstr_t(pField->GetName()); // 安全转换 BSTR }方案二：预定义映射数组（适合固定结构）
在对话框类中定义静态数组：
static const TCHAR* g_szFieldMap[] = { _T("id"), _T("name"), _T("value"), _T("created_time") }; #define FIELD_MAP_COUNT (sizeof(g_szFieldMap)/sizeof(g_szFieldMap[0])) CString CMyDlg::GetFieldNameByColumnIndex(long nColIndex) { if (nColIndex >= 0 && nColIndex < FIELD_MAP_COUNT) { return g_szFieldMap[nColIndex]; } return _T(""); }5.4 重绑定性能优化：避免频繁 Close/Open，用 Resync 替代
每次排序都Close()再Open()Recordset 效率低下，尤其数据量大时。ADO 提供Resync()方法，可在不关闭连接的前提下刷新数据，但需 Recordset 支持。更优解是：缓存原始 SQL，仅修改 ORDER BY 子句，并利用Requery()：
void CMyDlg::RebindDataSource(const CString& strSQL) { // 若 Recordset 已打开，先调用 Requery if (!m_Rs.GetEOF()) { try { m_Rs.Requery(adCmdText); // adCmdText 表示 strSQL 是文本命令 } catch (_com_error& e) { // Requery 失败则退化为 Close/Open m_Rs.Close(); m_Rs.Open(strSQL, ...); } } else { m_Rs.Open(strSQL, ...); } // 重绑定 _RecordsetPtr pRs = m_Rs.GetRecordset(); if (pRs != nullptr) { IUnknown* pUnk = pRs.GetInterfacePtr(); if (pUnk != nullptr) { pUnk->AddRef(); m_ctrlDG.SetRefDataSource(pUnk); } } }从那以后我每次做 DataGrid 排序，都强制走一遍
GetFixedRowRect坐标校验 +GetFieldNameByColumnIndex字段解析 +Requery重刷三步，宁可多写十行，也不信GetColContainingPoint的裸返回值。它在高 DPI 或多显示器环境下真的会飘。希望帮到你。
本文还有配套的精品资源，点击获取
