CListCtrl高级应用技巧：从基础到实战

1. CListCtrl基础入门从零开始掌握核心功能第一次接触CListCtrl时我完全被这个控件的强大功能震撼到了。作为MFC中最常用的列表展示控件它几乎出现在所有需要数据展示的Windows应用程序中。记得刚开始做项目时我还在傻傻地用ListBox控件来展示表格数据直到同事提醒才发现CListCtrl才是真正的神器。CListCtrl最基础的四种视图模式需要重点掌握大图标模式(LVS_ICON)类似Windows桌面的图标排列小图标模式(LVS_SMALLICON)图标较小可横向排列列表模式(LVS_LIST)单列展示带小图标报表模式(LVS_REPORT)多列表格形式功能最强大实际开发中前三种模式使用场景有限真正发挥威力的是报表模式。它支持多列数据展示、排序、复选框等高级功能是数据管理类应用的标配。创建基础CListCtrl只需要几行代码// 在对话框类头文件中声明 CListCtrl m_listCtrl; // 在OnInitDialog中初始化 m_listCtrl.Create(WS_CHILD|WS_VISIBLE|LVS_REPORT, CRect(10,10,400,200), this, IDC_LIST1);2. 报表模式深度解析打造专业数据展示界面2.1 列创建与样式设置报表模式的核心在于列管理。我曾在项目中遇到一个需求要动态生成包含20多列的复杂表格。通过反复实践总结出几个关键点// 添加三列示例 m_listCtrl.InsertColumn(0, _T(姓名), LVCFMT_LEFT, 100); m_listCtrl.InsertColumn(1, _T(年龄), LVCFMT_CENTER, 80); m_listCtrl.InsertColumn(2, _T(部门), LVCFMT_LEFT, 150); // 设置扩展样式 DWORD dwExStyle LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES | LVS_EX_CHECKBOXES; m_listCtrl.SetExtendedStyle(dwExStyle);这里有个坑我踩过SetExtendedStyle会覆盖之前的所有样式所以要用GetExtendedStyle先获取当前样式再或运算新样式。2.2 数据填充技巧数据填充看似简单但处理不当会导致性能问题。我优化过一个加载万行数据的案例m_listCtrl.SetRedraw(FALSE); // 禁止重绘提高性能 for(int i0; i10000; i){ int nItem m_listCtrl.InsertItem(i, _T(张三)); m_listCtrl.SetItemText(nItem, 1, _T(28)); m_listCtrl.SetItemText(nItem, 2, _T(研发部)); // 设置行高需要自定义绘制 m_listCtrl.SetItemData(nItem, (DWORD_PTR)30); } m_listCtrl.SetRedraw(TRUE); // 恢复重绘 m_listCtrl.Invalidate();3. 高级功能实战让你的列表更智能3.1 自定义绘制技巧默认的CListCtrl样式比较单调。通过自定义绘制可以实现斑马线、行高调整等效果。这是我常用的绘制框架// 在对话框消息映射中添加 ON_NOTIFY(NM_CUSTOMDRAW, IDC_LIST1, CMyDlg::OnNMCustomdrawList1) void CMyDlg::OnNMCustomdrawList1(NMHDR *pNMHDR, LRESULT *pResult) { NMLVCUSTOMDRAW* pLVCD reinterpret_castNMLVCUSTOMDRAW*(pNMHDR); switch(pLVCD-nmcd.dwDrawStage){ case CDDS_PREPAINT: *pResult CDRF_NOTIFYITEMDRAW; break; case CDDS_ITEMPREPAINT: // 奇数行灰色背景 if(pLVCD-nmcd.dwItemSpec % 2){ pLVCD-clrTextBk RGB(240,240,240); } *pResult CDRF_NEWFONT; break; } }3.2 排序功能实现点击列头排序是专业表格的必备功能。实现要点包括添加列点击消息处理ON_NOTIFY(LVN_COLUMNCLICK, IDC_LIST1, CMyDlg::OnLvnColumnclickList1)实现排序回调函数static int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort) { CMyData* pData1 (CMyData*)lParam1; CMyData* pData2 (CMyData*)lParam2; int nSort (int)lParamSort; // 根据nSort判断升序降序 return nSort 0 ? pData1-Compare(*pData2) : pData2-Compare(*pData1); }处理点击事件void CMyDlg::OnLvnColumnclickList1(NMHDR *pNMHDR, LRESULT *pResult) { LPNMLISTVIEW pNMLV reinterpret_castLPNMLISTVIEW(pNMHDR); int nCol pNMLV-iSubItem; // 设置排序标记 static int nSortOrder 1; nSortOrder -nSortOrder; m_listCtrl.SortItems(CompareFunc, nSortOrder); *pResult 0; }4. 性能优化与疑难问题解决4.1 大数据量处理方案处理10万数据时直接使用CListCtrl会导致界面卡死。我的解决方案是虚拟列表技术// 设置虚拟模式 m_listCtrl.SetItemCount(100000); m_listCtrl.SetExtendedStyle(LVS_EX_FULLROWSELECT | LVS_EX_DOUBLEBUFFER); // 处理LVN_GETDISPINFO消息 ON_NOTIFY(LVN_GETDISPINFO, IDC_LIST1, CMyDlg::OnLvnGetdispinfoList1) void CMyDlg::OnLvnGetdispinfoList1(NMHDR *pNMHDR, LRESULT *pResult) { NMLVDISPINFO *pDispInfo reinterpret_castNMLVDISPINFO*(pNMHDR); if(pDispInfo-item.mask LVIF_TEXT){ int nItem pDispInfo-item.iItem; int nSubItem pDispInfo-item.iSubItem; // 根据需要动态提供数据 _stprintf_s(pDispInfo-item.pszText, pDispInfo-item.cchTextMax, _T(数据%d-%d), nItem, nSubItem); } }分批加载机制// 处理滚动条消息 ON_WM_VSCROLL() void CMyDlg::OnVScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar) { if(pScrollBar-GetDlgCtrlID() IDC_LIST1){ SCROLLINFO si; m_listCtrl.GetScrollInfo(SB_VERT, si); // 接近底部时加载更多 if(nSBCode SB_THUMBTRACK nPos si.nMax - si.nPage/2){ LoadMoreData(); } } CDialog::OnVScroll(nSBCode, nPos, pScrollBar); }4.2 常见问题排查闪烁问题 除了使用SetRedraw还可以尝试双缓冲// 在OnInitDialog中添加 m_listCtrl.SetExtendedStyle(m_listCtrl.GetExtendedStyle() | LVS_EX_DOUBLEBUFFER);选中状态异常 确保同时设置以下三个状态m_listCtrl.SetItemState(nItem, LVIS_SELECTED|LVIS_FOCUSED, LVIS_SELECTED|LVIS_FOCUSED); m_listCtrl.SetSelectionMark(nItem); m_listCtrl.EnsureVisible(nItem, FALSE);内存泄漏 自定义绘制时特别注意// 在对话框析构函数中 if(m_listCtrl.GetImageList(LVSIL_SMALL)){ m_listCtrl.GetImageList(LVSIL_SMALL)-DeleteImageList(); }