虚表操作类v2.9.7[易语言源码]

虚表操作类v2.9.7易语言源码虚表操作类 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 越界崩溃。 使用建议：多线程更新虚表时，数据增删改请走上述公开方法，勿直接操作底层数组，以保证临界区覆盖完整。