虚表操作类 v2.9.7 改动总结

一、本次修复的 14 处问题

崩溃 / 稳定性（P0）

#1 自动调整列宽常量误用

原代码误用 #SPI_GETMOUSECLICKLOCK 作为列宽消息常量。该常量实际值 0x101E = 4126，与 LVM_SETCOLUMNWIDTH (4126) 数值巧合相同，功能虽"碰巧可用"，但命名严重误导。

修复：改用 #LVM_SETCOLUMNWIDTH 常量，消除歧义。

#2 单一选择模式逻辑反转（公开 + 私有方法）

原 单一选择_ 在"当前非单一选择 → 应清除 LVS_SINGLESEL"时被错误地加上了单一选择样式（非→非错误添加）。

修复：私有方法 单一选择_ 与公开方法 单一选择 同步修正为 .判断开始 (是否单一选择 = 假) / .默认 的正确分支逻辑。

#4 LVN_GETDISPINFOW 未检查"禁止重画"

父窗口消息处理 W 版（Unicode）分支缺少与 A 版一致的临界区 + 禁止重画判断，重画被禁用时仍触发回调。

修复：补齐与 A 版相同的判断逻辑。

#5 On_LvnGetdispinfo 数据读取未加锁（TOCTOU 竞争）

回调中读取 m_总数 与 m_列表数据 时没有进入临界区，多线程下存在读到的"半更新"数据而越界崩溃的风险。

修复：临界区覆盖 m_总数 + m_列表数据 的完整读取段，消除竞争。

逻辑错误 / 健壮性（P1）

#6 排序时未校验主键索引

排序入口未校验 m_主键索引 = 0（主键未绑定），可能用空索引表排序导致错乱。

修复：入口处若 m_主键索引 = 0 则输出调试文本并返回。

#7 创建时未校验主键列名

创建时若列名不存在导致 m_主键索引 未正确绑定，后续主键相关操作全部失效。

修复：列名不存在时弹窗报错并返回假。

#8 单一设置冗余调用

创建流程中重复调用了一次 单一选择_ (真, 真)，无意义。

修复：注释掉冗余的第二次调用。

#9 表头子类化未检查失败

SetWindowLong 子类化表头时未判断返回值，子类化失败仍继续，后续消息转发崩坏。

修复：补上 m_表头回调 = 0 或 -1 失败检查。

#10 列宽数组越界风险

自动调整列宽 未校验 取数组成员数(参_设置列宽) 与 m_列数 是否一致，数组不对称时越界。

修复：成员数不一致时返回假。

#11 复选框功能漏加 LVS_EX_CHECKBOXES（复选框闭环补全）

原代码在 置现行选中项（4096 + 61440 = 复选框未选中态）、插入一行（-4096 = 清除复选框状态）两处都写了复选框 state 操作，却唯独在 创建 中漏加 LVS_EX_CHECKBOXES 扩展样式，导致复选框功能根本不启用、state 代码变成"污染代码"。

修复：在 创建 中按参数启用 LVS_EX_CHECKBOXES，三处复选框代码形成闭环。（详见第二节新增参数）

#16 LVM_REDRAWITEMS 索引 off-by-one

原 LVM_REDRAWITEMS, 表项索引, 表项索引 + 1 三重错位：表项索引是 1-based，而该消息要求 0-based，且范围误写成 [i, i+1] 实际只应重画单个。

修复：idx = 表项索引 - 1; LVM_REDRAWITEMS, idx, idx，精准单行重画。

兼容性 / 设计改进（P2）

#13 静态变量多实例共享

父窗口消息处理的 iItem、hWndFrom 被声明为 静态，多个虚表实例会互相污染。

修复：去掉 静态 修饰符。

#14 创建时强制单一选择（无法选择）

原 创建 硬编码 nStyle = 位或(nStyle, #LVS_SINGLESEL)，用户无法关闭单一选择。

修复：新增 参_是否单一选择 参数，默认启用（兼容旧行为）。

#15 可视区索引 1-based/0-based 混用

是否处于可视区 中 参_行号索引 直接和操作系统的 0-based 滚动位置比较，边界判断偏移 1 行，预加载精度下降。

修复：令 R0 = 参_行号索引 - 1，判断 R0 >= T - 2 且 R0 <= T + 取可显示数量() + 2（上界多预加载 1 行，无害）。

二、新增 / 调整的参数

子程序	参数名	类型	说明
`创建`	`参_启用复选框`	逻辑型（可空）	是否启用复选框。默认（不填/为空）不启用，保持原外观；需要复选框时显式传 `真`
`创建`	`参_是否单一选择`	逻辑型（可空）	是否启用单一选择。`#14` 修复引入，默认真（兼容旧行为）
`置现行选中项`	`参_是否清除复选框`	逻辑型	选中行时是否同步清除该行复选框状态，解决原复选框逻辑与选中逻辑的冲突

三、线程安全加固说明

本版本重点加固了多线程场景下的数据一致性：

数据写侧：添加行数据、插入数据、更新行数据、删行数据、排序、清空数据、取表项数 全部通过同一 临界资源 临界区保护 m_总数 与 m_列表数据。

UI 读侧：On_LvnGetdispinfo 回调进入临界区读取 m_总数 + m_列表数据，彻底消除 TOCTOU 越界崩溃。

使用建议：多线程更新虚表时，数据增删改请走上述公开方法，勿直接操作底层数组，以保证临界区覆盖完整。

四、致谢与评审

本版修复经过多轮独立代码审查（HY3、Gemini 第三方视角各一轮），累计纠正了 2 处初始误判（HDLAYOUT 结构判定、Win32 常量值碰撞），并补充了 LVM_REDRAWITEMS off-by-one 等细节问题。修复方案均已逐条在源码层面验证通过。

结论：P0 全部修复，可上产线；原疑似 P2 的 #12（二维数组删除成员）经复核确认非 bug，无遗留问题。

精易论坛