简介面向MFC界面开发者的列表控件美化资源解决列表控件默认外观呆板、难以融入个性化界面设计的问题。资源聚焦滚动条、表头与列表项三个核心区域系统梳理了自定义控件类的创建与关联方式覆盖重绘滚动条必要的消息处理、表头布局调整、列表项自绘等关键环节并给出使用自绘样式时的注意事项适合想提升界面视觉表现、对控件自绘感兴趣的初中级开发者参考。压缩包共42个文件主要包含头文件、C源代码、位图资源与说明文档并附工程文件可直接打开示例整体仅87KB轻量精简可快速定位核心代码。目前已有325人学习下载示例工程中提供了完整的自绘列表控件封装读者可以对照代码理解绘制流程并将滚动条、表头和列表项的自定义逻辑迁移至自己的MFC项目减少重复开发。 编写自定义控件这件事一旦牵扯到系统原生组件就注定是一条“看着简单动手全是坑”的路。CListCtrl也就是我们常说的 ListView绝对是 MFC 里最常用的列表控件之一但它的默认外观实在配不上“现代应用”这四个字。尤其是当你需要做深色主题、高DPI适配、或者产品经理提出“选中行要高亮但不要变灰”这类细节要求时系统的默认行为根本不给你留活路。我最近正好花了一整块时间把一个 CListCtrl 从里到外重绘了一遍覆盖了滚动条、表头HeaderCtrl、和列表项Items三个核心区域顺便把“丢焦点后选中状态变灰”这个老顽固问题一并解决掉了。这篇文章就是这次改造的完整记录包含具体的绘制思路、关键代码片段以及我在过程中踩过的、让人血压升高的几个深坑。1. 整体设计思路拆解从“重绘”到“自绘”的认知转变1.1 为什么原生 CListCtrl 无法满足要求很多人第一次接到“美化列表”这个需求时第一反应是去设置控件的扩展样式比如 LVS_EX_GRIDLINES网格线、LVS_EX_FULLROWSELECT整行选中、LVS_EX_DOUBLEBUFFER双缓冲。这些确实能稍微改变外观但它们改变不了绘制的本质——CListCtrl 的绘制逻辑依然是系统托管的字体、间距、高亮颜色、滚动条样式全都由系统视觉主题Visual Style决定。一旦你打开了视觉风格也就是 comctl32.dll v6 之后的默认状态你能控制的只剩“颜色”那一层真正的绘制路径完全被系统接管。更关键的是如果你想把滚动条改成扁平样式、把表头加粗或增加自定义排序箭头、把选中行的高亮宽度撑满整个客户区系统默认根本做不到。这时候只有一条路能走把绘制权拿回来。这次实践中我最终选择的方案不是“在 WM_PAINT 上做手脚”而是采用“三块分治”的自绘策略——滚动条用自绘滚动条控件替换、表头用 HDM_ITEMDRAWING / CDN_DRAWITEM 拦截、列表项用 NM_CUSTOMDRAW 或者 OwnerDraw 接管。我实际选用的是 CUSTOMDRAW 为主OwnerDraw 为辅的混合方案先不急着上 OwnerDraw因为它是杀鸡用牛刀且会丢失很多默认行为。1.2 自绘范围的边界划分在动手写代码之前我建议你先想清楚一个问题到底是要“全部自绘”还是“局部优化”这两者在工作量上天差地别。全部自绘意味着连空白的客户区背景、每个 item 的文字绘制、甚至左键点击产生的热点跟踪效果都要自己模拟工作量大且容易出现细枝末节的 bug。而局部优化则是在尽可能保留系统行为的前提下只对“最影响观感”的区域做定制。我的这次重绘边界划分是这样的列表项区域由 NM_CUSTOMDRAW 拦截只处理选中态、焦点态、文本颜色和背景填充其余布局、命中测试、编辑框交互全部交给系统。表头则自绘全部背景和文字因为表头的默认样式对深色主题极不友好不改跟整体风格完全脱节。滚动条这边我直接放置了一个自绘的滚动条控件覆盖到系统滚动条的窗口区域上严格来说是让系统滚动条区域缩小为0再在那个区域绘制自己的滚动条。这样一个“混合自绘”模型的好处在于风险可控、代码量适中、且不会破坏 CListCtrl 本身的编辑、拖拽列宽、排序等原生交互。对大多数应用场景来说这是一条性价比极高的路径。2. 核心细节解析与实操要点三个区域的重绘实现2.1 滚动条重绘别在 WM_PAINT 里硬画要“替换控件”滚动条是 CListCtrl 重绘中最容易翻车的地方。很多初学者的第一想法是子类化 CListCtrl然后在 OnNcPaint 里自己画滚动条。我试过这条路非常难过因为系统通过 WM_NCCALCSIZE 控制非客户区的大小并且滚动条的绘制时机、位置和状态滑块的尺寸、位置、页面大小完全由系统计算你只能在系统画完之后叠加上去闪烁、残留、延迟问题会不断出现很难做到干净利落。我最终的方案是子类化 CListCtrl在 WM_NCCALCSIZE 中把窗口的非客户区滚动条区域计算成 0也就是告诉系统“我不需要原生的滚动条”然后在客户区的右侧预留一个固定宽度的矩形区域创建一个自绘的滚动条窗口CMyScrollBar依附在这个矩形上。这个自绘滚动条接收 WM_MOUSEWHEEL、WM_VSCROLL、WM_HSCROLL 消息自己维护滑块位置和页面信息并通过 SendMessage 给 CListCtrl 发送 WM_VSCROLL/WM_HSCROLL 消息完成实际滚动。关键点在于自绘滚动条需要实时感知 CListCtrl 的滚动范围和当前滚动位置。所以 CListCtrl 必须在 OnVScroll / OnHScroll 或者 OnNotify 中同步更新滚动条的状态。我给 CListCtrl 增加了一个 SyncScrollBar 方法在 WM_SIZE、WM_MOUSEWHEEL、和列表内容变化时调用 GetScrollInfo(SB_VERT / SB_HORZ) 获取当前信息再传递给并排版自绘滚动条。绘制滚动条时我用手动计算的方式画滑块的圆角矩形。绘制参数主要是三个轨道位置、滑块高度、上下箭头区域可选。扁平化之后我直接放弃了箭头按钮因为现代 UI 里箭头几乎被滚轮和触摸板取代了省掉箭头还能减少三分之一的绘制代码。滑块高度根据页面大小比例计算// 计算滑块高度 SCROLLINFO si { sizeof(SCROLLINFO) }; si.fMask SIF_ALL; GetScrollInfo(SB_VERT, si); int nScrollHeight (rcTrack.bottom - rcTrack.top); int nThumbHeight MulDiv(nScrollHeight, si.nPage, max(si.nMax - si.nMin 1, 1));这里有个小细节如果内容不足以产生滚动滑块高度会占满轨道此时通常直接隐藏滚动条避免出现“拖不动”的尴尬状态。2.2 HeaderCtrl 重绘使用 HDM_ITEMDRAWING 还是子类化表头Header Control的重绘常见方案有两种一种是在 CListCtrl 的子类里响应 HDN_ITEMDRAWING 反射通知另一种是单独子类化表头窗口。两种方案我都尝试过我的建议是除非你对列宽分割线、拖动反馈、排序箭头有很深入的自绘需求否则首先尝试 HDN_ITEMDRAWING 反射通知因为它不依赖额外的窗口对象代码组织更集中在 CListCtrl 的子类中。HDN_ITEMDRAWING 通知在表头项需要绘制时发送结构体是 NMHDR 和 NMCUSTOMDRAW 的合并体。它在表头每一项绘制时被调用你可以在这个通知内部完成背景、文本、排序指示符的绘制。难点在于当你在 HDN_ITEMDRAWING 中手动绘制文本时你已经不需要调用系统默认绘制所有绘制结果完全由你决定。此时像素对齐、字体选择、DPi 缩放就要格外小心。我的表头绘制代码核心逻辑如下先建立表头矩形用主题色填充整个背景。然后判断当前列是否处于鼠标悬停或按下状态——这个信息通过 Handle 的 pnmcd-dwItemSpec 和 pnmcd-uItemState 获取用深浅不一的背景色区分。表头文字绘制时我指定了 DT_SINGLELINE、DT_CENTER、DT_VCENTER并保证在最后一列时矩形宽度要扩展到包含整行因为表头默认在右侧有空白列否则会出现最右列文字对不齐列宽的问题。排序箭头则根据 CListCtrl 的 m_iSortColumn、m_bSortAscending 标志来绘制两个三角符号。由于 GDI 没有自带三角绘制函数我用 Polygon 手动指定三个顶点来绘制简单可靠且能精确控制尺寸和颜色。2.3 Items 自绘与选中态保持CUSTOMDRAW 为主OwnerDraw 为辅Items 重绘是整个改造里最核心的部分。CListCtrl 列表项绘制有两个标准入口NM_CUSTOMDRAW自定义绘制通知和 WM_DRAWITEMOwnerDraw 机制。其实从消息顺序上讲OwnerDraw 在 CUSTOMDRAW 之前前者适用于完全接管绘制后者适用于给系统画完之后“叠加修改”。我最终选择的是“以 NM_CUSTOMDRAW 为主”。核心原因是NM_CUSTOMDRAW 是分阶段通知你可以精确控制在“绘制之前”做哪些修改、“绘制之后”补哪些效果而且对 LVS_EX_FULLROWSELECT 的支持很好不会破坏系统自带的命中测试、热追踪和编辑框交互。NM_CUSTOMDRAW 的流程系统在绘制列表项的每个阶段都会发送 CDDS_NOTIFY 标志。返回值控制后续行为。一个典型的处理是这样if (pNMCD-hdr.code NM_CUSTOMDRAW) { LPNMLVCUSTOMDRAW pLVCD reinterpret_castLPNMLVCUSTOMDRAW(pNMCD); switch (pLVCD-nmcd.dwDrawStage) { case CDDS_PREPAINT: return CDRF_NOTIFYITEMDRAW; // 请求通知每个 item case CDDS_ITEMPREPAINT: // 在这里修改文字的字体颜色和背景色或设置自定义背景 SetTextColor(pLVCD-nmcd.hdc, RGB(...)); // 通过 pLVCD-clrText 更高效 SetBkColor(pLVCD-nmcd.hdc, RGB(...)); return CDRF_NEWFONT | CDRF_NOTIFYSUBITEMDRAW; case CDDS_SUBITEM | CDDS_ITEMPREPAINT: // 如果你要逐列绘制就在这里处理每个子项的文字格式 break; } }在选中态处理上有一个非常需要注意的点当你只是设置了 clrTextBk 或 clrText 时系统绘制时依然会先填充背景色然后绘制文本。但对于整行选中效果背景色撑满整行仅仅设置 clrTextBk 是不够的因为默认 ListView 的每个 item 背景只覆盖该列文字区域。这时候需要在 CDDS_ITEMPREPAINT 返回 CDRF_NOTIFYSUBITEMDRAW 后在 CDDS_SUBITEM 阶段主动用 FillRect 填充整行背景。这个填充操作需要先获取当前项的行矩形利用 GetItemRectiItem, rcItem, LVIR_BOUNDRECT获取边界——注意 LVIR_BOUNDRECT 返回的是整行的区域而 LVIR_LABEL 只是文字区域用错的话会出“选中高亮只有第一列有颜色”的问题。关于“丢焦点后保持高亮”的问题这是网络热搜词里大家最常问的。系统默认行为是当 CListCtrl 失去焦点后选中项会从高亮色变为灰色或淡色。这是因为系统绘制时对“选中态”和“焦点态”做了双重判断。解决办法有两个层次第一层重写 WM_KILLFOCUS 消息处理在失去焦点时强制刷新当前选中行RedrawItems这样即使在失焦状态下绘制代码依然会执行并且你可以在绘制代码里不区分“是否焦点”统一使用选中颜色。更彻底的替代方案是把 DrawText 的 DT_HIDEPREFIX 之外的状态判断逻辑里不再检查(pLVCD-nmcd.uItemState CDIS_SELECTED)是否与CDIS_FOCUS同时满足而只需判断选中状态即可。我封装了一个变量 m_bKeepSelHighlight当它为 TRUE 时选中项背景色一律使用主题高亮色不再关心窗口是否拥有焦点。第二层因为系统在某些默认绘制路径下会在失焦后自动将背景变灰所以你要保证所有绘制分支都不会走系统的“失焦灰化”逻辑。在 NM_CUSTOMDRAW 的 CDDS_PREPAINT 阶段直接返回 CDRF_NOTIFYITEMDRAW然后在 CDDS_ITEMPREPAINT 阶段用 FillRect 先画一个自定义背景。只要背景填充先行系统后续不会再覆盖它前提是你返回 CDRF_SKIPDEFAULT 或者至少不把背景绘制权交还给系统。最终代码里我除了把背景色固定为高亮色外文字颜色也在失焦时保持白色或浅色这样整个视觉在高亮态和非焦点态下基本一致。只有用户点击其他控件时选中行不再显示“灰蓝”看起来会专业得多。3. 实操过程与核心环节实现改造步骤全记录3.1 从标准 CListCtrl 到自绘子类的改造步骤整个改造流程我认为最合理的是分五步走每步都能独立编译和验证避免一次性改动量太大导致问题无法定位。第一步创建一个继承自 CListCtrl 的新类 CMyListCtrl在 OnInitDialog或者 OnCreate中设置扩展样式打开 LVS_EX_DOUBLEBUFFER避免闪烁、LVS_EX_FULLROWSELECT整行选中、LVS_EX_OWNERDRAWFIXED 先不要开因为我们走 CUSTOMDRAW 路线不需要 OwnerDraw。同时设置 LVS_SHOWSELALWAYS这个样式能让选中状态在失焦时依然保留。第二步重载 PreSubclassWindow把控件子类化绑定我们自己的消息处理函数。这一步非常关键如果你只是简单地在 Dialog 上创建一个 CListCtrl 变量然后试图用它来接收消息那么很多自定义消息根本收不到。需要在 PreSubclassWindow 中调用CRect rc; GetWindowRect(rc);之类的初始化逻辑然后用SubclassDlgItem或者直接对控件变量进行 DDX 绑定这是我后来反复检查发现的一个大坑——否则子类函数永远进不去。第三步实现 NM_CUSTOMDRAW 的处理函数。在消息映射里加上ON_NOTIFY_REFLECT(NM_CUSTOMDRAW, CMyListCtrl::OnNMCustomdraw)这是反射通知的写法表示该通知由控件自身处理而不是它的父窗口。然后按照前面讲的阶段分支写绘制逻辑。第四步表头自绘。在消息映射里增加ON_NOTIFY_REFLECT(HDN_ITEMDRAWING, CMyListCtrl::OnHdnItemdrawing)。注意HDN_ITEMDRAWING 是要先获取 Header 控件的指针然后给它发送 HDM_SETUNICODEFORMAT否则字符串显示可能乱码。第五步滚动条改造。按前面说的方法在 WM_NCCALCSIZE 中先把系统滚动条全部干掉把标志位改为 0然后在客户区内画一个自绘滚动条。这一步需要额外实现 CMyScrollBar 类但它本身逻辑简单维护滑块位置和外观即可。3.2 关键代码三项核心绘制逻辑拆解3.2.1 列表项选中态绘制Items这是所有重绘里最重要的一段代码。我做了以下处理在 CDDS_ITEMPREPAINT 阶段判断当前项是否被选中。如果选中首先获取整行矩形再使用主题色对其进行 FillRect。这里我用了一个比较稳妥的技巧将背景填充逻辑放在绘制文本之前并且不调用系统的默认绘制。case CDDS_ITEMPREPAINT: { DWORD dwState pLVCD-nmcd.uItemState; if (dwState CDIS_SELECTED) { // 全行填充高亮背景 CRect rcItem; m_ListCtrl.GetItemRect((int)pLVCD-nmcd.dwItemSpec, rcItem, LVIR_BOUNDRECT); // 填充整行 FillRect(pLVCD-nmcd.hdc, rcItem, m_brHighlight); pLVCD-clrText RGB(255,255,255); pLVCD-clrTextBk RGB(0, 120, 215); return CDRF_NEWFONT; } ... }这里要解释为什么设置 clrTextBk 还要额外 FillRect因为 clrTextBk 只管文本的背景它不会撑满整行。而视觉上我们希望选中高亮覆盖整行所以必须手动填充。与此同时为了让系统在画完文本后不叠加背景色我需要将clrTextBk设置为和我填充的相同颜色双保险。另外还有一个隐藏的坑当 ListView 处于报告模式下每一列都是一个 SubItem如果你在 ITEMPREPAINT 阶段已经 FillRect 了整行那么后续 CDDS_SUBITEM | CDDS_ITEMPREPAINT 阶段系统还会用默认背景绘制每个子项。因此你需要在 CDDS_PREPAINT 返回 CDRF_NOTIFYITEMDRAW并且在 ITEMPREPAINT 之后继续返回 CDRF_NOTIFYSUBITEMDRAW然后在 SUBITEM 阶段同样设置 clrTextBk 为高亮色避免系统填充覆盖。3.2.2 表头背景与排序箭头绘制HeaderCtrl表头绘制的核心逻辑相对独立。在 HDN_ITEMDRAWING 里你会拿到一个 NMCUSTOMDRAW 指针它的 rc 成员就是当前列目标矩形。我先把矩形用主题深色填充然后把列标题文本用 DrawText 居中绘制。LRESULT CMyListCtrl::OnHdnItemdrawing(NMHDR* pNMHDR) { LPNMCUSTOMDRAW pNMCD (LPNMCUSTOMDRAW)pNMHDR; if (pNMCD-dwDrawStage CDDS_PREPAINT) { return CDRF_NOTIFYITEMDRAW; } if (pNMCD-dwDrawStage CDDS_ITEMPREPAINT) { CRect rc(pNMCD-rc); // 背景 FillRect(pNMCD-hdc, rc, m_brHeaderBg); // 分割线 CPen pen(PS_SOLID, 1, m_colorHeaderBorder); CPen* pOldPen (CPen*)pNMCD-hdc-SelectObject(pen); pNMCD-hdc-MoveTo(rc.right - 1, rc.top); pNMCD-hdc-LineTo(rc.right - 1, rc.bottom); // 绘制文字 CString strText GetHeaderCtrl()-GetItemText(pNMCD-dwItemSpec); rc.DeflateRect(8, 0, 8, 0); pNMCD-hdc-SetBkMode(TRANSPARENT); pNMCD-hdc-SetTextColor(m_colorHeaderText); pNMCD-hdc-DrawText(strText, rc, DT_CENTER | DT_VCENTER | DT_SINGLELINE); // 排序箭头 if ((int)pNMCD-dwItemSpec m_iSortColumn) { DrawSortArrow(pNMCD-hdc, rc, m_bSortAscending); } return CDRF_SKIPDEFAULT; } return CDRF_DODEFAULT; }排序箭头的绘制我用的是简单三角形不需要额外引入图标资源。DrawSortArrow 内部通过 Polygon 绘制一个小三角上升箭头向上下降箭头向下。需要留意的是HDN_ITEMDRAWING 通知中的 rc 矩形在最后一个列之后有时不包含右侧空白列所以如果你期望表头背景能铺满整行可能需要手动判断这是最后一列并向右扩展到客户区宽度。这个细节不处理的话深色主题下最右侧会出现一条刺眼的默认白色竖条。3.2.3 滚动条绘制与状态同步Scrollbar滚动条作为独立自绘控件类它的 OnPaint 逻辑不复杂。核心是绘制轨道和滑块void CMyScrollBar::OnPaint() { CPaintDC dc(this); CRect rcClient; GetClientRect(rcClient); // 绘制轨道 dc.FillSolidRect(rcClient, m_colorTrack); // 根据当前位置计算滑块矩形 SCROLLINFO si m_SI; // 由外部同步进来 int nMax si.nMax; int nMin si.nMin; int nPage si.nPage; int nPos si.nPos; int nRange nMax - nMin 1; int nTrackHeight rcClient.Height(); int nThumbHeight MulDiv(nTrackHeight, nPage, max(nRange, 1)); nThumbHeight max(nThumbHeight, 20); // 最小高度 int nThumbPos MulDiv(nTrackHeight - nThumbHeight, nPos - nMin, max(nRange - nPage, 1)); CRect rcThumb(rcClient.left 1, nThumbPos, rcClient.right - 1, nThumbPos nThumbHeight); // 绘制滑块 if (m_bPressed) { dc.FillSolidRect(rcThumb, m_colorThumbPressed); } else { dc.FillSolidRect(rcThumb, m_colorThumbNormal); } }滑块位置计算公式里关键是nThumbHeight MulDiv(nTrackHeight, nPage, nRange)即滑块高度与“页面大小/总范围”成正比。位置则是nThumbPos MulDiv(nTrackHeight - nThumbHeight, nPos - nMin, nRange - nPage)这个公式把当前的滚动位置映射到滑块移动区间内。别小看这两个公式我一开始直接用 nPos / nMax 的线性比例结果滚动条在滚动到末尾时滑块总会提前顶到底后来换上 MulDiv 的标准化公式才解决。这里有个容易忽略的陷阱MulDiv是以 32 位有符号整数作为中间结果的当 nRange 特别大时可能会溢出但通常 CListCtrl 的条目数不会超过几百万实际使用没问题。如果你处理的是超大规模数据建议自己用 double 或 int64 计算。外部同步的逻辑核心代码这样写void CMyListCtrl::SyncScrollBarPos() { SCROLLINFO si { sizeof(SCROLLINFO) }; si.fMask SIF_ALL; GetScrollInfo(SB_VERT, si); m_vertScrollBar.SetScrollInfo(si); }在 OnMouseWheel、OnVScroll 和 WM_SIZE 之后调用这个函数。对于水平滚动条也是同理不过通常列表内容较少时可以把水平滚动条直接隐藏避免出现“底部多了一条横向白条”的丑态。3.3 焦点与选中态保持的完整方案“丢去焦点变灰”这个热搜词背后的需求很明确用户希望在点击其他地方比如一个编辑框或按钮时列表中选中的行依然保持高亮而不是变成系统默认的灰色。这在实际应用中非常常见比如列表作为主从视图的“主视图”时选中了一个设备右侧显示详情用户点击右侧详情区域时左侧列表高亮还是应该保持否则视觉上会让人误以为选中状态消失了。完整的做法是“两步走”第一步在 CMyListCtrl 中重写OnKillFocus设置一个标志位 m_bHasFocus FALSE并调用 Invalidate() 或 RedrawItems() 强制重绘。这里不要调用默认的 CListCtrl::OnKillFocus因为默认实现会通知系统重绘选中项并采用失焦灰化效果。但由于我们已经在 NM_CUSTOMDRAW 里接管了背景所以即使系统发了重绘我们依然会用自己的高亮色绘制。第二步在绘制时不区分窗口是否拥有焦点。我封装了一个方法IsItemSelected(LPNMLVCUSTOMDRAW pLVCD)它判断(pLVCD-nmcd.uItemState CDIS_SELECTED)在实际使用时如果m_bKeepSelHighlight为 TRUE就忽略 CDIS_FOCUS 状态。这样无论是 GetFocus 返回 NULL 还是别的控件获得焦点选中行都会使用相同的高亮效果。如果你希望更深一步在对话框级别直接阻止 CListCtrl 丢焦点时重绘选中项也可以在父窗口处理WM_KILLFOCUS后调用SendMessage(WM_NEXTDLGCTL)把焦点强制交还但这种做法容易把用户的 Tab 切换逻辑搞乱不推荐。还是通过重绘自控最稳妥。4. 常见问题与排查技巧实录你一定会碰到的几个坑4.1 选中背景色出现“条纹”或“白色闪烁”这个问题通常发生在你只设置了 clrTextBk 高亮色但没有在 SUBITEM 阶段也设置背景。当列表启用网格线或者列数较多时系统绘制子项时会再次用默认背景填充导致背景变成白/高亮交替的条纹。解决办法是在每个 subitem 分支里都判断选中态并设置 clrTextBk并且填充时要和主背景一致。闪烁问题则可以靠开启 LVS_EX_DOUBLEBUFFER 解决。要注意的是如果你的列表启用了自绘滚动条千万不要在滚动条绘制时使用 InvalidateRect 的整窗口刷新否则滚动时会产生剧烈的闪烁。正确做法是滚动时只更新客户区需要变化的部分即使用 ScrollWindow 或局部 Invalidate。4.2 表头最后一个列右侧出现默认白色区域这是比较经典的问题。当表头总宽度小于客户区宽度时系统会在右侧画出额外的空白列这个区域的绘制通知是 HDN_ITEMDRAWING 之外的逻辑。解决方法是在 HDN_ITEMDRAWING 的绘制中判断当前列是不是最后一列如果是将绘制矩形扩展至客户区右边界即 m_ListCtrl.GetClientRect 的右边界这样表头背景才能铺满。另外如果你使用了 CListCtrl 的 SetColumnOrderArray 来调整列顺序表头绘制顺序会被打乱不能简单地用列索引判断“最后一列”需要结合列顺序数组处理。4.3 自绘滚动条滚动范围不准滚不到底这个问题我排查了很久最终发现是 GetScrollInfo 和 SetScrollInfo 的标志位设置不对。GetScrollInfo 时需要指定 si.fMask SIF_ALL它才会返回 nMin、nMax、nPage、nPos、nTrackPos 全部字段。如果漏了 SIF_PAGEnPage 为 0滑块高度计算就会出错。另外注意一个细节CListCtrl 设置了 LVS_OWNERDRAWFIXED 或 LVS_OWNERDATA 之后滚动信息的变化时机和普通列表不同。尤其是在 owner-data 模式下nMax 需要根据数据条数手动计算或通过 SetScrollInfo 主动设置。我在代码里每次 OnVScroll 结束后都会立刻同步一次滚动条状态防止用户快速拖动时出现滑块和实际滚动位置不同步的卡顿感。4.4 失焦后选中行变白或变淡但高亮绘制代码不生效这种情况最隐蔽。有时你确实在 NM_CUSTOMDRAW 中对选中项设置了背景色但失焦后选中行依然变灰。原因是系统在 DrawItem 流程中如果发现 ListView 的 LVS_SHOWSELALWAYS 没有设置或者控件自身没有焦点它会在某些阶段直接跳过自定义绘制分支走默认的灰色填充。这也就是为什么必须设置LVS_SHOWSELALWAYS扩展样式。同时如果你用了“OwnerDraw”也就是 LVS_OWNERDRAWFIXED绘制逻辑就得完全由 WM_DRAWITEM 承担在 WM_DRAWITEM 里自己绘制背景、文本、焦点框任何一项遗漏都会导致视觉异常。我建议优先使用 NM_CUSTOMDRAW它更贴合系统原有的子项绘制逻辑。4.5 文本绘制模糊尤其在高DPI下CListCtrl 的高 DPI 适配经常被忽略。重绘时如果你用CreateFont创建字体时指定了像素高度而不是点大小那么在 150% 缩放的屏幕上字体会发虚。解决方案是使用CreatePointFont或者在 WM_DPICHANGED 后重建字体。同时绘制文本时使用SetMapMode保持 MM_TEXT 模式不要在这段代码里做任何坐标缩放否则会乱套。另外如果你在 NM_CUSTOMDRAW 里使用了DrawText一定注意DT_SINGLELINE | DT_VCENTER | DT_CENTER这些标志的组合。不要同时设置 DT_SINGLELINE 和 DT_WORDBREAK后者会强制换行导致文本在窄列里被截断成两行影响观感。4.6 关于“取消所有选择行”的实现细化热搜里还有“clistctrl 取消所有选择行”这个需求。我实际处理中通常有几种触发场景清空按钮、按下 ESC、刷新后重置选中。核心代码非常简单// 取消所有选中 POSITION pos GetFirstSelectedItemPosition(); while (pos) { int nItem GetNextSelectedItem(pos); SetItemState(nItem, 0, LVIS_SELECTED | LVIS_FOCUSED); }但这里有一个性能陷阱如果你有几千行数据使用 SetItemState 逐项取消会非常慢因为每次都会触发重绘。更高效的做法是调用SetItemState(-1, 0, LVIS_SELECTED | LVIS_FOCUSED)这个 API 直接对所有 item 生效一条调用搞定。实测在 5 万行的 ListView 上逐项取消耗时可能超过 2 秒而整体取消只需要几毫秒。代码写到这个程度基本上就把 CListCtrl 的自绘骨架搭起来了。我自己改完这个控件后最大的一个体会是系统控件不是不能改而是要找到正确的“改法”不是硬画而是拦截它的绘制通知然后巧妙地把自己的绘制逻辑嵌进去。滚动条、表头、列表项这三个区域本质上都是独立的消息机制你只要把各自的通知消息吃透再刻意练习一下坐标和状态的同步最后拿到的效果会比直接改视觉主题稳定得多。最后分享一个小技巧无论你重绘了多少内容一定要在 WM_THEMECHANGED 之后重新加载颜色资源和重建字体。很多看起来“莫名奇妙”的显示问题其实只是系统切换主题后你自绘的逻辑没有跟着更新颜色缓存导致的。我把所有颜色、画刷、字体都封装成了缓存成员变量主题一变就重建这次改造之后在系统深浅色切换下也没有出现任何闪色、残留的诡异现象。本文还有配套的精品资源点击获取
CListCtrl自绘实战：滚动条、表头、选中态保持全解析
简介面向MFC界面开发者的列表控件美化资源解决列表控件默认外观呆板、难以融入个性化界面设计的问题。资源聚焦滚动条、表头与列表项三个核心区域系统梳理了自定义控件类的创建与关联方式覆盖重绘滚动条必要的消息处理、表头布局调整、列表项自绘等关键环节并给出使用自绘样式时的注意事项适合想提升界面视觉表现、对控件自绘感兴趣的初中级开发者参考。压缩包共42个文件主要包含头文件、C源代码、位图资源与说明文档并附工程文件可直接打开示例整体仅87KB轻量精简可快速定位核心代码。目前已有325人学习下载示例工程中提供了完整的自绘列表控件封装读者可以对照代码理解绘制流程并将滚动条、表头和列表项的自定义逻辑迁移至自己的MFC项目减少重复开发。 编写自定义控件这件事一旦牵扯到系统原生组件就注定是一条“看着简单动手全是坑”的路。CListCtrl也就是我们常说的 ListView绝对是 MFC 里最常用的列表控件之一但它的默认外观实在配不上“现代应用”这四个字。尤其是当你需要做深色主题、高DPI适配、或者产品经理提出“选中行要高亮但不要变灰”这类细节要求时系统的默认行为根本不给你留活路。我最近正好花了一整块时间把一个 CListCtrl 从里到外重绘了一遍覆盖了滚动条、表头HeaderCtrl、和列表项Items三个核心区域顺便把“丢焦点后选中状态变灰”这个老顽固问题一并解决掉了。这篇文章就是这次改造的完整记录包含具体的绘制思路、关键代码片段以及我在过程中踩过的、让人血压升高的几个深坑。1. 整体设计思路拆解从“重绘”到“自绘”的认知转变1.1 为什么原生 CListCtrl 无法满足要求很多人第一次接到“美化列表”这个需求时第一反应是去设置控件的扩展样式比如 LVS_EX_GRIDLINES网格线、LVS_EX_FULLROWSELECT整行选中、LVS_EX_DOUBLEBUFFER双缓冲。这些确实能稍微改变外观但它们改变不了绘制的本质——CListCtrl 的绘制逻辑依然是系统托管的字体、间距、高亮颜色、滚动条样式全都由系统视觉主题Visual Style决定。一旦你打开了视觉风格也就是 comctl32.dll v6 之后的默认状态你能控制的只剩“颜色”那一层真正的绘制路径完全被系统接管。更关键的是如果你想把滚动条改成扁平样式、把表头加粗或增加自定义排序箭头、把选中行的高亮宽度撑满整个客户区系统默认根本做不到。这时候只有一条路能走把绘制权拿回来。这次实践中我最终选择的方案不是“在 WM_PAINT 上做手脚”而是采用“三块分治”的自绘策略——滚动条用自绘滚动条控件替换、表头用 HDM_ITEMDRAWING / CDN_DRAWITEM 拦截、列表项用 NM_CUSTOMDRAW 或者 OwnerDraw 接管。我实际选用的是 CUSTOMDRAW 为主OwnerDraw 为辅的混合方案先不急着上 OwnerDraw因为它是杀鸡用牛刀且会丢失很多默认行为。1.2 自绘范围的边界划分在动手写代码之前我建议你先想清楚一个问题到底是要“全部自绘”还是“局部优化”这两者在工作量上天差地别。全部自绘意味着连空白的客户区背景、每个 item 的文字绘制、甚至左键点击产生的热点跟踪效果都要自己模拟工作量大且容易出现细枝末节的 bug。而局部优化则是在尽可能保留系统行为的前提下只对“最影响观感”的区域做定制。我的这次重绘边界划分是这样的列表项区域由 NM_CUSTOMDRAW 拦截只处理选中态、焦点态、文本颜色和背景填充其余布局、命中测试、编辑框交互全部交给系统。表头则自绘全部背景和文字因为表头的默认样式对深色主题极不友好不改跟整体风格完全脱节。滚动条这边我直接放置了一个自绘的滚动条控件覆盖到系统滚动条的窗口区域上严格来说是让系统滚动条区域缩小为0再在那个区域绘制自己的滚动条。这样一个“混合自绘”模型的好处在于风险可控、代码量适中、且不会破坏 CListCtrl 本身的编辑、拖拽列宽、排序等原生交互。对大多数应用场景来说这是一条性价比极高的路径。2. 核心细节解析与实操要点三个区域的重绘实现2.1 滚动条重绘别在 WM_PAINT 里硬画要“替换控件”滚动条是 CListCtrl 重绘中最容易翻车的地方。很多初学者的第一想法是子类化 CListCtrl然后在 OnNcPaint 里自己画滚动条。我试过这条路非常难过因为系统通过 WM_NCCALCSIZE 控制非客户区的大小并且滚动条的绘制时机、位置和状态滑块的尺寸、位置、页面大小完全由系统计算你只能在系统画完之后叠加上去闪烁、残留、延迟问题会不断出现很难做到干净利落。我最终的方案是子类化 CListCtrl在 WM_NCCALCSIZE 中把窗口的非客户区滚动条区域计算成 0也就是告诉系统“我不需要原生的滚动条”然后在客户区的右侧预留一个固定宽度的矩形区域创建一个自绘的滚动条窗口CMyScrollBar依附在这个矩形上。这个自绘滚动条接收 WM_MOUSEWHEEL、WM_VSCROLL、WM_HSCROLL 消息自己维护滑块位置和页面信息并通过 SendMessage 给 CListCtrl 发送 WM_VSCROLL/WM_HSCROLL 消息完成实际滚动。关键点在于自绘滚动条需要实时感知 CListCtrl 的滚动范围和当前滚动位置。所以 CListCtrl 必须在 OnVScroll / OnHScroll 或者 OnNotify 中同步更新滚动条的状态。我给 CListCtrl 增加了一个 SyncScrollBar 方法在 WM_SIZE、WM_MOUSEWHEEL、和列表内容变化时调用 GetScrollInfo(SB_VERT / SB_HORZ) 获取当前信息再传递给并排版自绘滚动条。绘制滚动条时我用手动计算的方式画滑块的圆角矩形。绘制参数主要是三个轨道位置、滑块高度、上下箭头区域可选。扁平化之后我直接放弃了箭头按钮因为现代 UI 里箭头几乎被滚轮和触摸板取代了省掉箭头还能减少三分之一的绘制代码。滑块高度根据页面大小比例计算// 计算滑块高度 SCROLLINFO si { sizeof(SCROLLINFO) }; si.fMask SIF_ALL; GetScrollInfo(SB_VERT, si); int nScrollHeight (rcTrack.bottom - rcTrack.top); int nThumbHeight MulDiv(nScrollHeight, si.nPage, max(si.nMax - si.nMin 1, 1));这里有个小细节如果内容不足以产生滚动滑块高度会占满轨道此时通常直接隐藏滚动条避免出现“拖不动”的尴尬状态。2.2 HeaderCtrl 重绘使用 HDM_ITEMDRAWING 还是子类化表头Header Control的重绘常见方案有两种一种是在 CListCtrl 的子类里响应 HDN_ITEMDRAWING 反射通知另一种是单独子类化表头窗口。两种方案我都尝试过我的建议是除非你对列宽分割线、拖动反馈、排序箭头有很深入的自绘需求否则首先尝试 HDN_ITEMDRAWING 反射通知因为它不依赖额外的窗口对象代码组织更集中在 CListCtrl 的子类中。HDN_ITEMDRAWING 通知在表头项需要绘制时发送结构体是 NMHDR 和 NMCUSTOMDRAW 的合并体。它在表头每一项绘制时被调用你可以在这个通知内部完成背景、文本、排序指示符的绘制。难点在于当你在 HDN_ITEMDRAWING 中手动绘制文本时你已经不需要调用系统默认绘制所有绘制结果完全由你决定。此时像素对齐、字体选择、DPi 缩放就要格外小心。我的表头绘制代码核心逻辑如下先建立表头矩形用主题色填充整个背景。然后判断当前列是否处于鼠标悬停或按下状态——这个信息通过 Handle 的 pnmcd-dwItemSpec 和 pnmcd-uItemState 获取用深浅不一的背景色区分。表头文字绘制时我指定了 DT_SINGLELINE、DT_CENTER、DT_VCENTER并保证在最后一列时矩形宽度要扩展到包含整行因为表头默认在右侧有空白列否则会出现最右列文字对不齐列宽的问题。排序箭头则根据 CListCtrl 的 m_iSortColumn、m_bSortAscending 标志来绘制两个三角符号。由于 GDI 没有自带三角绘制函数我用 Polygon 手动指定三个顶点来绘制简单可靠且能精确控制尺寸和颜色。2.3 Items 自绘与选中态保持CUSTOMDRAW 为主OwnerDraw 为辅Items 重绘是整个改造里最核心的部分。CListCtrl 列表项绘制有两个标准入口NM_CUSTOMDRAW自定义绘制通知和 WM_DRAWITEMOwnerDraw 机制。其实从消息顺序上讲OwnerDraw 在 CUSTOMDRAW 之前前者适用于完全接管绘制后者适用于给系统画完之后“叠加修改”。我最终选择的是“以 NM_CUSTOMDRAW 为主”。核心原因是NM_CUSTOMDRAW 是分阶段通知你可以精确控制在“绘制之前”做哪些修改、“绘制之后”补哪些效果而且对 LVS_EX_FULLROWSELECT 的支持很好不会破坏系统自带的命中测试、热追踪和编辑框交互。NM_CUSTOMDRAW 的流程系统在绘制列表项的每个阶段都会发送 CDDS_NOTIFY 标志。返回值控制后续行为。一个典型的处理是这样if (pNMCD-hdr.code NM_CUSTOMDRAW) { LPNMLVCUSTOMDRAW pLVCD reinterpret_castLPNMLVCUSTOMDRAW(pNMCD); switch (pLVCD-nmcd.dwDrawStage) { case CDDS_PREPAINT: return CDRF_NOTIFYITEMDRAW; // 请求通知每个 item case CDDS_ITEMPREPAINT: // 在这里修改文字的字体颜色和背景色或设置自定义背景 SetTextColor(pLVCD-nmcd.hdc, RGB(...)); // 通过 pLVCD-clrText 更高效 SetBkColor(pLVCD-nmcd.hdc, RGB(...)); return CDRF_NEWFONT | CDRF_NOTIFYSUBITEMDRAW; case CDDS_SUBITEM | CDDS_ITEMPREPAINT: // 如果你要逐列绘制就在这里处理每个子项的文字格式 break; } }在选中态处理上有一个非常需要注意的点当你只是设置了 clrTextBk 或 clrText 时系统绘制时依然会先填充背景色然后绘制文本。但对于整行选中效果背景色撑满整行仅仅设置 clrTextBk 是不够的因为默认 ListView 的每个 item 背景只覆盖该列文字区域。这时候需要在 CDDS_ITEMPREPAINT 返回 CDRF_NOTIFYSUBITEMDRAW 后在 CDDS_SUBITEM 阶段主动用 FillRect 填充整行背景。这个填充操作需要先获取当前项的行矩形利用 GetItemRectiItem, rcItem, LVIR_BOUNDRECT获取边界——注意 LVIR_BOUNDRECT 返回的是整行的区域而 LVIR_LABEL 只是文字区域用错的话会出“选中高亮只有第一列有颜色”的问题。关于“丢焦点后保持高亮”的问题这是网络热搜词里大家最常问的。系统默认行为是当 CListCtrl 失去焦点后选中项会从高亮色变为灰色或淡色。这是因为系统绘制时对“选中态”和“焦点态”做了双重判断。解决办法有两个层次第一层重写 WM_KILLFOCUS 消息处理在失去焦点时强制刷新当前选中行RedrawItems这样即使在失焦状态下绘制代码依然会执行并且你可以在绘制代码里不区分“是否焦点”统一使用选中颜色。更彻底的替代方案是把 DrawText 的 DT_HIDEPREFIX 之外的状态判断逻辑里不再检查(pLVCD-nmcd.uItemState CDIS_SELECTED)是否与CDIS_FOCUS同时满足而只需判断选中状态即可。我封装了一个变量 m_bKeepSelHighlight当它为 TRUE 时选中项背景色一律使用主题高亮色不再关心窗口是否拥有焦点。第二层因为系统在某些默认绘制路径下会在失焦后自动将背景变灰所以你要保证所有绘制分支都不会走系统的“失焦灰化”逻辑。在 NM_CUSTOMDRAW 的 CDDS_PREPAINT 阶段直接返回 CDRF_NOTIFYITEMDRAW然后在 CDDS_ITEMPREPAINT 阶段用 FillRect 先画一个自定义背景。只要背景填充先行系统后续不会再覆盖它前提是你返回 CDRF_SKIPDEFAULT 或者至少不把背景绘制权交还给系统。最终代码里我除了把背景色固定为高亮色外文字颜色也在失焦时保持白色或浅色这样整个视觉在高亮态和非焦点态下基本一致。只有用户点击其他控件时选中行不再显示“灰蓝”看起来会专业得多。3. 实操过程与核心环节实现改造步骤全记录3.1 从标准 CListCtrl 到自绘子类的改造步骤整个改造流程我认为最合理的是分五步走每步都能独立编译和验证避免一次性改动量太大导致问题无法定位。第一步创建一个继承自 CListCtrl 的新类 CMyListCtrl在 OnInitDialog或者 OnCreate中设置扩展样式打开 LVS_EX_DOUBLEBUFFER避免闪烁、LVS_EX_FULLROWSELECT整行选中、LVS_EX_OWNERDRAWFIXED 先不要开因为我们走 CUSTOMDRAW 路线不需要 OwnerDraw。同时设置 LVS_SHOWSELALWAYS这个样式能让选中状态在失焦时依然保留。第二步重载 PreSubclassWindow把控件子类化绑定我们自己的消息处理函数。这一步非常关键如果你只是简单地在 Dialog 上创建一个 CListCtrl 变量然后试图用它来接收消息那么很多自定义消息根本收不到。需要在 PreSubclassWindow 中调用CRect rc; GetWindowRect(rc);之类的初始化逻辑然后用SubclassDlgItem或者直接对控件变量进行 DDX 绑定这是我后来反复检查发现的一个大坑——否则子类函数永远进不去。第三步实现 NM_CUSTOMDRAW 的处理函数。在消息映射里加上ON_NOTIFY_REFLECT(NM_CUSTOMDRAW, CMyListCtrl::OnNMCustomdraw)这是反射通知的写法表示该通知由控件自身处理而不是它的父窗口。然后按照前面讲的阶段分支写绘制逻辑。第四步表头自绘。在消息映射里增加ON_NOTIFY_REFLECT(HDN_ITEMDRAWING, CMyListCtrl::OnHdnItemdrawing)。注意HDN_ITEMDRAWING 是要先获取 Header 控件的指针然后给它发送 HDM_SETUNICODEFORMAT否则字符串显示可能乱码。第五步滚动条改造。按前面说的方法在 WM_NCCALCSIZE 中先把系统滚动条全部干掉把标志位改为 0然后在客户区内画一个自绘滚动条。这一步需要额外实现 CMyScrollBar 类但它本身逻辑简单维护滑块位置和外观即可。3.2 关键代码三项核心绘制逻辑拆解3.2.1 列表项选中态绘制Items这是所有重绘里最重要的一段代码。我做了以下处理在 CDDS_ITEMPREPAINT 阶段判断当前项是否被选中。如果选中首先获取整行矩形再使用主题色对其进行 FillRect。这里我用了一个比较稳妥的技巧将背景填充逻辑放在绘制文本之前并且不调用系统的默认绘制。case CDDS_ITEMPREPAINT: { DWORD dwState pLVCD-nmcd.uItemState; if (dwState CDIS_SELECTED) { // 全行填充高亮背景 CRect rcItem; m_ListCtrl.GetItemRect((int)pLVCD-nmcd.dwItemSpec, rcItem, LVIR_BOUNDRECT); // 填充整行 FillRect(pLVCD-nmcd.hdc, rcItem, m_brHighlight); pLVCD-clrText RGB(255,255,255); pLVCD-clrTextBk RGB(0, 120, 215); return CDRF_NEWFONT; } ... }这里要解释为什么设置 clrTextBk 还要额外 FillRect因为 clrTextBk 只管文本的背景它不会撑满整行。而视觉上我们希望选中高亮覆盖整行所以必须手动填充。与此同时为了让系统在画完文本后不叠加背景色我需要将clrTextBk设置为和我填充的相同颜色双保险。另外还有一个隐藏的坑当 ListView 处于报告模式下每一列都是一个 SubItem如果你在 ITEMPREPAINT 阶段已经 FillRect 了整行那么后续 CDDS_SUBITEM | CDDS_ITEMPREPAINT 阶段系统还会用默认背景绘制每个子项。因此你需要在 CDDS_PREPAINT 返回 CDRF_NOTIFYITEMDRAW并且在 ITEMPREPAINT 之后继续返回 CDRF_NOTIFYSUBITEMDRAW然后在 SUBITEM 阶段同样设置 clrTextBk 为高亮色避免系统填充覆盖。3.2.2 表头背景与排序箭头绘制HeaderCtrl表头绘制的核心逻辑相对独立。在 HDN_ITEMDRAWING 里你会拿到一个 NMCUSTOMDRAW 指针它的 rc 成员就是当前列目标矩形。我先把矩形用主题深色填充然后把列标题文本用 DrawText 居中绘制。LRESULT CMyListCtrl::OnHdnItemdrawing(NMHDR* pNMHDR) { LPNMCUSTOMDRAW pNMCD (LPNMCUSTOMDRAW)pNMHDR; if (pNMCD-dwDrawStage CDDS_PREPAINT) { return CDRF_NOTIFYITEMDRAW; } if (pNMCD-dwDrawStage CDDS_ITEMPREPAINT) { CRect rc(pNMCD-rc); // 背景 FillRect(pNMCD-hdc, rc, m_brHeaderBg); // 分割线 CPen pen(PS_SOLID, 1, m_colorHeaderBorder); CPen* pOldPen (CPen*)pNMCD-hdc-SelectObject(pen); pNMCD-hdc-MoveTo(rc.right - 1, rc.top); pNMCD-hdc-LineTo(rc.right - 1, rc.bottom); // 绘制文字 CString strText GetHeaderCtrl()-GetItemText(pNMCD-dwItemSpec); rc.DeflateRect(8, 0, 8, 0); pNMCD-hdc-SetBkMode(TRANSPARENT); pNMCD-hdc-SetTextColor(m_colorHeaderText); pNMCD-hdc-DrawText(strText, rc, DT_CENTER | DT_VCENTER | DT_SINGLELINE); // 排序箭头 if ((int)pNMCD-dwItemSpec m_iSortColumn) { DrawSortArrow(pNMCD-hdc, rc, m_bSortAscending); } return CDRF_SKIPDEFAULT; } return CDRF_DODEFAULT; }排序箭头的绘制我用的是简单三角形不需要额外引入图标资源。DrawSortArrow 内部通过 Polygon 绘制一个小三角上升箭头向上下降箭头向下。需要留意的是HDN_ITEMDRAWING 通知中的 rc 矩形在最后一个列之后有时不包含右侧空白列所以如果你期望表头背景能铺满整行可能需要手动判断这是最后一列并向右扩展到客户区宽度。这个细节不处理的话深色主题下最右侧会出现一条刺眼的默认白色竖条。3.2.3 滚动条绘制与状态同步Scrollbar滚动条作为独立自绘控件类它的 OnPaint 逻辑不复杂。核心是绘制轨道和滑块void CMyScrollBar::OnPaint() { CPaintDC dc(this); CRect rcClient; GetClientRect(rcClient); // 绘制轨道 dc.FillSolidRect(rcClient, m_colorTrack); // 根据当前位置计算滑块矩形 SCROLLINFO si m_SI; // 由外部同步进来 int nMax si.nMax; int nMin si.nMin; int nPage si.nPage; int nPos si.nPos; int nRange nMax - nMin 1; int nTrackHeight rcClient.Height(); int nThumbHeight MulDiv(nTrackHeight, nPage, max(nRange, 1)); nThumbHeight max(nThumbHeight, 20); // 最小高度 int nThumbPos MulDiv(nTrackHeight - nThumbHeight, nPos - nMin, max(nRange - nPage, 1)); CRect rcThumb(rcClient.left 1, nThumbPos, rcClient.right - 1, nThumbPos nThumbHeight); // 绘制滑块 if (m_bPressed) { dc.FillSolidRect(rcThumb, m_colorThumbPressed); } else { dc.FillSolidRect(rcThumb, m_colorThumbNormal); } }滑块位置计算公式里关键是nThumbHeight MulDiv(nTrackHeight, nPage, nRange)即滑块高度与“页面大小/总范围”成正比。位置则是nThumbPos MulDiv(nTrackHeight - nThumbHeight, nPos - nMin, nRange - nPage)这个公式把当前的滚动位置映射到滑块移动区间内。别小看这两个公式我一开始直接用 nPos / nMax 的线性比例结果滚动条在滚动到末尾时滑块总会提前顶到底后来换上 MulDiv 的标准化公式才解决。这里有个容易忽略的陷阱MulDiv是以 32 位有符号整数作为中间结果的当 nRange 特别大时可能会溢出但通常 CListCtrl 的条目数不会超过几百万实际使用没问题。如果你处理的是超大规模数据建议自己用 double 或 int64 计算。外部同步的逻辑核心代码这样写void CMyListCtrl::SyncScrollBarPos() { SCROLLINFO si { sizeof(SCROLLINFO) }; si.fMask SIF_ALL; GetScrollInfo(SB_VERT, si); m_vertScrollBar.SetScrollInfo(si); }在 OnMouseWheel、OnVScroll 和 WM_SIZE 之后调用这个函数。对于水平滚动条也是同理不过通常列表内容较少时可以把水平滚动条直接隐藏避免出现“底部多了一条横向白条”的丑态。3.3 焦点与选中态保持的完整方案“丢去焦点变灰”这个热搜词背后的需求很明确用户希望在点击其他地方比如一个编辑框或按钮时列表中选中的行依然保持高亮而不是变成系统默认的灰色。这在实际应用中非常常见比如列表作为主从视图的“主视图”时选中了一个设备右侧显示详情用户点击右侧详情区域时左侧列表高亮还是应该保持否则视觉上会让人误以为选中状态消失了。完整的做法是“两步走”第一步在 CMyListCtrl 中重写OnKillFocus设置一个标志位 m_bHasFocus FALSE并调用 Invalidate() 或 RedrawItems() 强制重绘。这里不要调用默认的 CListCtrl::OnKillFocus因为默认实现会通知系统重绘选中项并采用失焦灰化效果。但由于我们已经在 NM_CUSTOMDRAW 里接管了背景所以即使系统发了重绘我们依然会用自己的高亮色绘制。第二步在绘制时不区分窗口是否拥有焦点。我封装了一个方法IsItemSelected(LPNMLVCUSTOMDRAW pLVCD)它判断(pLVCD-nmcd.uItemState CDIS_SELECTED)在实际使用时如果m_bKeepSelHighlight为 TRUE就忽略 CDIS_FOCUS 状态。这样无论是 GetFocus 返回 NULL 还是别的控件获得焦点选中行都会使用相同的高亮效果。如果你希望更深一步在对话框级别直接阻止 CListCtrl 丢焦点时重绘选中项也可以在父窗口处理WM_KILLFOCUS后调用SendMessage(WM_NEXTDLGCTL)把焦点强制交还但这种做法容易把用户的 Tab 切换逻辑搞乱不推荐。还是通过重绘自控最稳妥。4. 常见问题与排查技巧实录你一定会碰到的几个坑4.1 选中背景色出现“条纹”或“白色闪烁”这个问题通常发生在你只设置了 clrTextBk 高亮色但没有在 SUBITEM 阶段也设置背景。当列表启用网格线或者列数较多时系统绘制子项时会再次用默认背景填充导致背景变成白/高亮交替的条纹。解决办法是在每个 subitem 分支里都判断选中态并设置 clrTextBk并且填充时要和主背景一致。闪烁问题则可以靠开启 LVS_EX_DOUBLEBUFFER 解决。要注意的是如果你的列表启用了自绘滚动条千万不要在滚动条绘制时使用 InvalidateRect 的整窗口刷新否则滚动时会产生剧烈的闪烁。正确做法是滚动时只更新客户区需要变化的部分即使用 ScrollWindow 或局部 Invalidate。4.2 表头最后一个列右侧出现默认白色区域这是比较经典的问题。当表头总宽度小于客户区宽度时系统会在右侧画出额外的空白列这个区域的绘制通知是 HDN_ITEMDRAWING 之外的逻辑。解决方法是在 HDN_ITEMDRAWING 的绘制中判断当前列是不是最后一列如果是将绘制矩形扩展至客户区右边界即 m_ListCtrl.GetClientRect 的右边界这样表头背景才能铺满。另外如果你使用了 CListCtrl 的 SetColumnOrderArray 来调整列顺序表头绘制顺序会被打乱不能简单地用列索引判断“最后一列”需要结合列顺序数组处理。4.3 自绘滚动条滚动范围不准滚不到底这个问题我排查了很久最终发现是 GetScrollInfo 和 SetScrollInfo 的标志位设置不对。GetScrollInfo 时需要指定 si.fMask SIF_ALL它才会返回 nMin、nMax、nPage、nPos、nTrackPos 全部字段。如果漏了 SIF_PAGEnPage 为 0滑块高度计算就会出错。另外注意一个细节CListCtrl 设置了 LVS_OWNERDRAWFIXED 或 LVS_OWNERDATA 之后滚动信息的变化时机和普通列表不同。尤其是在 owner-data 模式下nMax 需要根据数据条数手动计算或通过 SetScrollInfo 主动设置。我在代码里每次 OnVScroll 结束后都会立刻同步一次滚动条状态防止用户快速拖动时出现滑块和实际滚动位置不同步的卡顿感。4.4 失焦后选中行变白或变淡但高亮绘制代码不生效这种情况最隐蔽。有时你确实在 NM_CUSTOMDRAW 中对选中项设置了背景色但失焦后选中行依然变灰。原因是系统在 DrawItem 流程中如果发现 ListView 的 LVS_SHOWSELALWAYS 没有设置或者控件自身没有焦点它会在某些阶段直接跳过自定义绘制分支走默认的灰色填充。这也就是为什么必须设置LVS_SHOWSELALWAYS扩展样式。同时如果你用了“OwnerDraw”也就是 LVS_OWNERDRAWFIXED绘制逻辑就得完全由 WM_DRAWITEM 承担在 WM_DRAWITEM 里自己绘制背景、文本、焦点框任何一项遗漏都会导致视觉异常。我建议优先使用 NM_CUSTOMDRAW它更贴合系统原有的子项绘制逻辑。4.5 文本绘制模糊尤其在高DPI下CListCtrl 的高 DPI 适配经常被忽略。重绘时如果你用CreateFont创建字体时指定了像素高度而不是点大小那么在 150% 缩放的屏幕上字体会发虚。解决方案是使用CreatePointFont或者在 WM_DPICHANGED 后重建字体。同时绘制文本时使用SetMapMode保持 MM_TEXT 模式不要在这段代码里做任何坐标缩放否则会乱套。另外如果你在 NM_CUSTOMDRAW 里使用了DrawText一定注意DT_SINGLELINE | DT_VCENTER | DT_CENTER这些标志的组合。不要同时设置 DT_SINGLELINE 和 DT_WORDBREAK后者会强制换行导致文本在窄列里被截断成两行影响观感。4.6 关于“取消所有选择行”的实现细化热搜里还有“clistctrl 取消所有选择行”这个需求。我实际处理中通常有几种触发场景清空按钮、按下 ESC、刷新后重置选中。核心代码非常简单// 取消所有选中 POSITION pos GetFirstSelectedItemPosition(); while (pos) { int nItem GetNextSelectedItem(pos); SetItemState(nItem, 0, LVIS_SELECTED | LVIS_FOCUSED); }但这里有一个性能陷阱如果你有几千行数据使用 SetItemState 逐项取消会非常慢因为每次都会触发重绘。更高效的做法是调用SetItemState(-1, 0, LVIS_SELECTED | LVIS_FOCUSED)这个 API 直接对所有 item 生效一条调用搞定。实测在 5 万行的 ListView 上逐项取消耗时可能超过 2 秒而整体取消只需要几毫秒。代码写到这个程度基本上就把 CListCtrl 的自绘骨架搭起来了。我自己改完这个控件后最大的一个体会是系统控件不是不能改而是要找到正确的“改法”不是硬画而是拦截它的绘制通知然后巧妙地把自己的绘制逻辑嵌进去。滚动条、表头、列表项这三个区域本质上都是独立的消息机制你只要把各自的通知消息吃透再刻意练习一下坐标和状态的同步最后拿到的效果会比直接改视觉主题稳定得多。最后分享一个小技巧无论你重绘了多少内容一定要在 WM_THEMECHANGED 之后重新加载颜色资源和重建字体。很多看起来“莫名奇妙”的显示问题其实只是系统切换主题后你自绘的逻辑没有跟着更新颜色缓存导致的。我把所有颜色、画刷、字体都封装成了缓存成员变量主题一变就重建这次改造之后在系统深浅色切换下也没有出现任何闪色、残留的诡异现象。本文还有配套的精品资源点击获取