必须设置OwnerDraw=true才能触发DrawItem事件;需同时订阅DrawItem、DrawSubItem、DrawColumnHeader三个事件;DrawSubItem中用e.ItemIndex判断奇偶行;背景色须用e.Graphics.FillRectangle绘制而非e.DrawBackground()。
ListView.DrawItem 事件必须启用 OwnerDraw
默认 listview 不支持隔行变色,因为系统绘制逻辑完全由 windows 控件托管。想自定义背景色,就得接管绘制权——但很多人漏掉关键一步:ownerdraw 属性没设为 true,结果 drawitem 事件压根不触发。
实操建议:
-
listView1.OwnerDraw = true;必须在初始化控件后、绑定数据前设置 - 同时要订阅三个事件:
DrawItem(画每一行)、DrawSubItem(画每列内容)、DrawColumnHeader(画表头),否则可能部分区域空白或重绘错乱 - 如果用了
View = View.Details,只处理DrawItem是不够的;子项颜色得靠DrawSubItem单独控制
DrawSubItem 中判断行号要用 e.ItemIndex
容易误用 e.ColumnIndex 或循环索引,导致奇偶行错位。真正决定“哪一行”的是 e.ItemIndex,它和数据源顺序一致,不受排序、筛选、滚动影响。
常见错误现象:拖动滚动条后隔行色突然错乱,或者点击列标题排序后颜色全乱。
实操建议:
- 在
DrawSubItem里统一用if (e.ItemIndex % 2 == 0)判断偶数行 - 别依赖
listView1.Items.IndexOf(e.Item),这个在虚拟模式或大量数据时性能差,且可能返回 -1 - 如果启用了
CheckBoxes = true,第一列是复选框,e.ColumnIndex == 0时不画背景,避免遮盖勾选框
背景填充必须调用 e.Graphics.FillRectangle
只改 e.DrawBackground() 不起作用——这个方法实际是空实现,.NET Framework 和 .NET Core/5+ 都如此。真正生效的是手动填充矩形。
性能与兼容性注意点:
- 用
e.Graphics.FillRectangle(Brushes.LightBlue, e.Bounds)而不是e.DrawBackground() - 填充前先调用
e.DrawFocusRectangle()(如果需要焦点虚线框),否则焦点状态不可见 - 避免在每次绘制中 new Brush,复用
static readonly SolidBrush更稳妥,尤其在快速滚动时防止 GC 压力 - .NET 6+ WinForms 对高 DPI 支持更好,但若项目目标是 .NET Framework 4.7.2,记得在 app.manifest 里加
dpiAware=true,否则缩放后颜色块错位
虚拟模式下 ListViewItem.Tag 可用来缓存行状态
当 ListView 数据量大(比如上万行)并启用 VirtualMode = true 时,Items 集合为空,e.ItemIndex 仍是可靠来源,但无法通过 Items[e.ItemIndex] 拿对象。此时若需按业务规则变色(比如“已完成”行固定绿色),不能硬编码奇偶逻辑。
实操建议:
- 在
RetrieveVirtualItem事件中,给每个ListViewItem的Tag赋值一个轻量状态标识(如bool isCompleted或int priority) - 在
DrawSubItem里用(bool?)e.Item.Tag判断,比反复查数据库或集合快得多 - 不要把整个业务对象塞进
Tag,避免内存泄漏;只存必要字段,尤其别存 UI 控件引用
OwnerDraw = true 这个前提——设晚了或根本没设,后面所有代码都白写。










