简介面向 Delphi 12.3Athens开发者的 EhLib VCL 10.2.42 控件库完整安装包专为需要在 VCL 项目中快速集成高级表格、数据库网格与报表界面的程序员准备。资源共收录 1491 个文件以 pas/Dcu 源码与编译单元、dfm 窗体设计文件、hpp 头文件及 res/dcr 资源文件为核心附带 chm 帮助文档与示例项目整体约 25.56MB可满足控件部署、二次开发与学习参考需求。已有 93 人学习下载适合中高级 Delphi 开发者按需选用。解压后可获得完整控件源码、设计期与运行期包、官方帮助索引及多个演示工程方便对照验证控件在 Delphi 12.3 下的行为与最佳实践减少自行探索编译环境的时间成本。1. 当“表格控件”成为开发效率的分水岭在 Delphi 12.3 Athens 版本里做桌面数据库应用大部分团队会在一件事上产生明显分歧表格用什么。自带 TDBGrid 能用但要做多表头、行着色、下拉列表、树形分组就要自己堆代码项目周期一长界面逻辑和业务逻辑纠缠在一起后续维护的代价远高于一开始选对控件。EhLib VCL 恰好是干这个的它在 Delphi 生态里作为“增强版表格与数据感知控件集”存在10.2.42 这个版本号明确支持 12.3 Athens解决的就是“原装网格控件不够用”和“第三方控件装不上”这两类问题。对正在从 D7 往高版本迁移的团队、把 VCL 应用从 Win32 带到 Win64 的工程师以及刚下载 Delphi 12.3 绿色版想在本地搭一套顺手控件的开发者来说装好 EhLib 并把它配置正确比琢磨任何“高级架构”都更能直接提升表格类功能的开发速度。本文按安装、数据组件、数据集操作、典型错误和进阶验证的顺序把 10.2.42 在 Athens 上的使用边界讲清楚。2. 装进 Delphi 12.3 Athens解压路径、lib 目录与 IDE 注册2.1 先搞懂 EhLib 的目录结构里有什么拿到EhLib VCL 10.2.42 for Delphi 12 Athens.7z之后第一件事不是双击安装程序而是注意它的形态这是一个压缩包不是 exe 安装包。这个细节很关键因为很多团队习惯了“一路 Next”的组件安装方式碰到手动解压的包就不知道下一步做什么。解压后你会看到大致结构Lib目录按 Win32/Win64 分列 .dcu、.bpl、.res 等文件、Source目录部分版本保留 .pas 源文件方便调试时跟踪控件内部逻辑、Samples目录带示例项目建议保留、Docs目录含 HTML 帮助或 PDF含属性参考。重点在于Lib目录。10.2.42 针对 Athens 编译的 dcu 和 bpl 都放在这里你的 IDE 必须精确指向这一层否则会出现“找到源文件但找不到编译产物”的错位。提示如果你下载的是所谓“Delphi 12.3 绿色版”而非官方安装版IDE 对库路径的搜索顺序会有差异建议优先把 EhLib 的路径放在 Tools Options Library 列表的靠前位置减少被同名文件干扰的可能。2.2 手动注册 bpl 包的完整流程虽然各版本细节略有差异但 VCL 控件安装的标准路径依然是“先编译包再安装包”。打开你的 Delphi 12.3 Athens按以下步骤去操作。2.2.1 打开并编译设计期包进入Lib目录找到类似EhLib120.bpk或dclEhLib120.bpk的工程文件。dcl前缀表示设计期包Design-Time Package运行时包通常不带前缀。操作顺序为// 以下不是代码而是 IDE 操作序列 1. File Open选择 dclEhLib120.bpk 2. Project Manager 窗口中右键该包选择 Compile 3. 编译成功后右键选择 Install编译这一步常见的失败原因是路径不对。如果 IDE 报找不到某个 .dcu先去Tools Options Library Library paths里添加解压后的根目录和Lib\Win32或Lib\Win64目录。添加后重开 Project Manager再编译通常就能通过。2.2.2 确认 IDE 菜单里出现 EhLib 分页安装成功后组件面板上会多出一个或几个带 EhLib 字样的标签页里面有TDBGridEh、TDBEditEh、TDBLookupComboboxEh等组件。看到它们说明运行时包和设计期包都正常注册了。如果你用的绿色版缺少某些注册表项组件面板可能不刷新。此时在 IDE 里执行Component Install Packages点击 Add手动选中刚才编译生成的dclEhLib120.bpl文件确定后即可强制加载。2.3 安装失败时你最需要看的三个信号安装阶段最容易踩的坑集中在三个信号上第一个信号是Package ... is not found。这往往是 bpl 文件所在目录不在系统 PATH 中导致的。把Lib\Win32或Lib\Win64加到系统环境变量 PATH 中并完全重启 Delphi即可解决。第二个信号是Cannot load package ...。这通常意味着运行时包和设计期包版本不匹配例如你编译了运行时包但安装的是旧的设计期包。回到Lib目录把同批次的 .bpl 全部拷到同一目录再做安装。第三个信号是 IDE 崩溃或启动时弹错误框。多数情况是不同版本的 EhLib 残留在注册表里。打开注册表编辑器定位到HKEY_CURRENT_USER\Software\Embarcadero\BDS\23.0\Known PackagesAthens 的 BDS 版本号以实际为准把含 EhLib 的旧条目删掉再重新安装。注意在安装过程中如果出现“SQLite 乱码”类的问题先不要怀疑 EhLib 的编码支持而应在后面配置数据集时检查VCLUnicode相关属性这一步通常会暴露真正的字符转换边界。3. 数据感知组件实战从 DBGridEh 到 EditEh 的属性地图3.1 DBGridEh 不是“换皮 DBGrid”很多人把TDBGridEh当作 DBGrid 的皮肤版只为了加个斑马纹或行号这是极大的浪费。EhLib 真正值钱的地方在于列的构建方式、数据呈现逻辑以及和数据集交互的行为控制。先看最常用的列设置。在设计期双击 DBGridEh打开列编辑器添加几列并设置关键属性// 列属性关键配置示例在设计期 Object Inspector 中操作 DBGridEh1.Columns[0].FieldName : OrderNo; DBGridEh1.Columns[0].Title.Caption : 订单号; DBGridEh1.Columns[0].Width : 120; DBGridEh1.Columns[0].Title.TitleButton : True; DBGridEh1.Columns[1].FieldName : OrderDate; DBGridEh1.Columns[1].Title.Caption : 下单日期; DBGridEh1.Columns[1].Width : 130; DBGridEh1.Columns[1].DisplayFormat : yyyy-mm-dd;这里的TitleButton置为 True 后网格标题可以点击排序。但真正的排序逻辑并不由网格独自完成它需要通过事件去驱动数据集排序否则只是视觉上有个“排序箭头”而数据纹丝不动。常用的做法是在TitleBtnClick事件里调用TDataSet的排序方法。下拉列表和数据绑定是 DBGridEh 的另一大杀器。使用TDBLookupComboboxEh作为列的 InPlaceEditor 时你不需要额外放一个查询组件直接在列里指定LookupDataField和KeyField即可// 设置某列为下拉选择 DBGridEh1.Columns[2].FieldName : CustomerID; DBGridEh1.Columns[2].DropDownShow : True; // 在设计期指定 Columns[2].LookupParams 关联到客户表这个思路比手工弹窗体选值要简洁得多因为它完全在网格内部完成数据展示和编辑的联动并且能保留数据库外键的原始值而不是把显示文本写回数据集。3.2 EditEh 与 SpinEditEh 的输入收敛表格场景里用户输入常常是错误高发区。日期格式不对、数字带逗号、字符串前后空格这些都能在数据校验环节消耗大量时间。EhLib 的TDBEditEh通过EditMask和ValueChecked/ValueUnchecked属性把所有校验前移到了控件层。// 金额输入框只允许数字和点 DBEditEh1.EditMask : 999999.99; // 相当于三位小数但更精确的做法 DBEditEh1.DisplayFormat : 0.00; DBEditEh1.EditFormat : 0.00;DisplayFormat和EditFormat的分离是一个值得注意的设计点。显示时自动补小数点后两位编辑时按用户输入原样显示这能避免“编辑时看得到格式符反而容易输错”的体验问题。TSpinEditEh适合数量类输入。它的一个被低估的属性是MaxValue和MinValue很多人以为这只是界面上按钮的边界实际它会在输入非法值时自动拒绝不需要在 AfterPost 中再判断一次。3.3 表格控件在“只读报表”场景下的属性收敛表格控件不只是用于编辑更常见的场景是只读报表。此时建议把 DataGrouping 和行高设置结合起来用。例如按状态字段分组显示// 启用数据分组 DBGridEh1.DataGrouping.Active : True; DBGridEh1.DataGrouping.GroupLevels.Clear; DBGridEh1.DataGrouping.GroupLevels.Add.FieldName : Status; DBGridEh1.DataGrouping.GroupLevels[0].FooterText : 组内记录数; DBGridEh1.DataGrouping.GroupLevels[0].FooterValueType : fvtCount;这里的FooterValueType : fvtCount是分组统计的快速入口它自动计算每组行数避免你在 SQL 里写COUNT(*) OVER(PARTITION BY ...)。对 5 年以上 Delphi 经验的工程师来说这可以省掉一批原本要交给 SQL 的轻量统计需求。4. 数据集操作边界排序、过滤与“cannot perform this operation on an open dataset”4.1 为什么你会遇上 “cannot perform this operation on an open dataset”在 Delphi 12.3 Athens 上使用 EhLib 时搜索关联度最高的报错之一就是cannot perform this operation on an open dataset。很多人第一反应是组件 Bug其实这个错误来自 VCL 本身的TDataSet保护机制而不是 EhLib 的缺陷。它意味着你的代码在数据集已经打开的情况下执行了要求数据集处于关闭状态的操作典型例子是在运行时修改DataSource.DataSet.CommandText、重新赋值TableName或调用某些需要重建游标的函数。常见触发场景是这样的// 错误示例数据集已打开又尝试设 CommandText with ADODataSet1 do begin if Active then Close; // 必须主动关闭 CommandText : SELECT * FROM Orders; Open; end;EhLib 的组件在感知数据集结构变化时会触发内部元数据刷新如果底层数据集状态不对就很容易把这个错误提前引爆。而正确做法是在修改任何定义数据结构的属性之前保证数据集处于关闭状态。4.2 运行时排序与过滤的标准写法EhLib 的排序和过滤能力依赖数据集的游标定位但它的DBGridEh.SortMarkedColumns机制和 TClientDataSet 的IndexFieldNames配合尤其顺滑。以下是一段可复用的排序模板procedure TForm1.DBGridEh1TitleBtnClick(Sender: TObject; ACol: Integer; Column: TColumnEh); var FieldName: string; begin FieldName : Column.FieldName; if FieldName then Exit; with ClientDataSet1 do begin if Active then Close; IndexFieldNames : FieldName; Open; end; end;注意Close之后再Open这个动作它是规避“open dataset”错误的最直接手段。在数据量达到十万行以上时这种重建索引的代价可能达到几百毫秒用户体感会很差。这时可以把IndexFieldNames换成TClientDataSet的IndexName预先建立好持久化索引修改IndexName不需要关闭数据集。过滤方面EhLib 提供DBGridEh.STFilter的局部过滤但它最终要落到数据集的Filter或OnFilterRecord上。推荐使用TDataSet.Filter配合Filtered : True因为这种方式可以保留滚动状态不会重置游标。// 设置网格过滤条件 DBGridEh1.STFilter.Local : True; DBGridEh1.STFilter.Visibility : [fvNonEmpty]; DBGridEh1.STFilter.FilterOnTyping : True; // 实际生效仍然需要数据集 Filter ClientDataSet1.Filter : Status QuotedStr(Paid); ClientDataSet1.Filtered : True;FilterOnTyping : True的代价是每次按键都可能触发数据集刷新如果数据源是远程数据库建议设置为 False只在用户按回车时联动刷新。4.3 TreeViewEh 与关系型数据的层次展示关系数据的树形展示是 TDBGridEh 本身覆盖不到的EhLib 提供TTreeViewEh来解决。它和 VCL 自带 TTreeView 最大的区别是它可以绑定到一个带有父子关系字段的 DataSet并自动维护节点的展开状态。设置方式为TreeViewEh1.DataSource : DataSource1; // 数据源 TreeViewEh1.KeyField : ID; TreeViewEh1.RefParentField : ParentID; TreeViewEh1.RefTextField : Name; TreeViewEh1.TreeMode : True;TreeMode开启后节点层级由RefParentField的递归关系决定你不再需要手工循环插入节点这对于“部门-子部门”“分类-子分类”这类结构是很明显的效率提升。常见的误用是在 TreeViewEh 上同时启用DataSource和手动AddChild逻辑这会导致节点重复、展开状态错乱。二选一要么让数据驱动要么走纯手工构建节点混用是排错时最难收拾的局面。5. 进阶验证在 12.3 上批量压测 DBGridEh 渲染与内存表场景5.1 用虚拟数据集跑一遍百万行渲染在宽带和内存都足够的情况下EhLib 在大数据量下的表现主要取决于数据集读取模式和网格的绘制策略。这里给一个可复现的最小化压测方案用 TClientDDataSet 在内存中生成假数据然后观察滚动和绘制的帧率。procedure TForm1.GenerateData; var i: Integer; begin ClientDataSet1.CreateDataSet; ClientDataSet1.DisableControls; try for i : 1 to 100000 do begin ClientDataSet1.Append; ClientDataSet1.FieldByName(ID).AsInteger : i; ClientDataSet1.FieldByName(Name).AsString : Name_ IntToStr(i); ClientDataSet1.FieldByName(Amount).AsFloat : i * 1.5; ClientDataSet1.Post; end; finally ClientDataSet1.EnableControls; end; end;这段代码的关键在于DisableControls它停止网格在每次数据变更时的逐行刷新让数据插入速度提升一个数量级。注意它的副作用在禁用控制期间用户界面不会显示滚动进度如果你的界面需要实时反馈就不要在大循环里使用。接下来针对渲染做优化。在 DBGridEh 属性中HorzScrollBar和VertScrollBar的Tracking若为 True则在滚动过程中会实时绘制全部可见记录这会让老机器卡顿建议在数据量大的场景设为 False只在滚动停止后刷新画面。5.2 一个容易被忽略的验证技巧用 Stopwatch 测 ActualCountEhLib 的全部表格组件都有DataSource.DataSet.RecordCount可用但有些数据集类型如TFDQuery是异步获取的直接读 RecordCount 会触发完整的数据集加载性能反而更差。此时用DBGridEh.DataGrouping的分组统计量可以避免全表扫描。还可尝试准则如果你怀疑是网格绘制拖慢了界面在主窗体 OnKeyUp 中临时切换DBGridEh1.OptionsEh里的dghExtendVertLines和dghTraceColSizing如果切换后滚动明显变快说明你的机器在抗锯齿线和列分割绘制上吃掉了大部分帧时间。// 临时关闭网格垂直辅助线用于定位绘制瓶颈 DBGridEh1.OptionsEh : DBGridEh1.OptionsEh - [dghExtendVertLines]; DBGridEh1.Invalidate;这里Invalidate是必要的否则界面不会立即反映属性变化。5.3 和 UniGUI 的边界什么场景不该用 EhLib搜索热词里出现了unigui for delphi下载这里需要明确一个边界EhLib 是 VCL 控件它的运行环境是 Windows 桌面应用。如果你要把业务系统搬到浏览器上EhLib 的网格组件不能直接跨到 UniGUI 里。UniGUI 有自己的一套基于 ExtJS 的表格体系两者在数据绑定模式、事件模型、渲染方式上完全不同。如果团队确实需要 Web 化比较务实的方式是保留现有 VCL 业务逻辑层把界面层重写为 UniGUI 的 TUniDBGrid。强行在 UniGUI 中嵌入 VCL 窗口宿主不仅性能差而且会在焦点处理、滚动条、弹窗层级等细节上浪费大量调试时间。这条经验适用于所有 VCL 控件不只 EhLib。结尾处给出一个可落地的判据评估现有页面里如果 70% 以上交互是“看表格、筛选、编辑单行”UniGUI 重写成本可控反之如果有大量复杂的行合并、表头分组、就地统计建议保留桌面版 VCL 应用或者干脆考虑其他成熟 Web 前端方案。EhLib 10.2.42 在 Athens 上的价值正是在它把桌面端这些复杂交互做到极致Web 端则需要另寻出路。本文还有配套的精品资源点击获取 Delphi 12.3 Athens 下 EhLib VCL 10.2.42 安装与表格实战
简介面向 Delphi 12.3Athens开发者的 EhLib VCL 10.2.42 控件库完整安装包专为需要在 VCL 项目中快速集成高级表格、数据库网格与报表界面的程序员准备。资源共收录 1491 个文件以 pas/Dcu 源码与编译单元、dfm 窗体设计文件、hpp 头文件及 res/dcr 资源文件为核心附带 chm 帮助文档与示例项目整体约 25.56MB可满足控件部署、二次开发与学习参考需求。已有 93 人学习下载适合中高级 Delphi 开发者按需选用。解压后可获得完整控件源码、设计期与运行期包、官方帮助索引及多个演示工程方便对照验证控件在 Delphi 12.3 下的行为与最佳实践减少自行探索编译环境的时间成本。1. 当“表格控件”成为开发效率的分水岭在 Delphi 12.3 Athens 版本里做桌面数据库应用大部分团队会在一件事上产生明显分歧表格用什么。自带 TDBGrid 能用但要做多表头、行着色、下拉列表、树形分组就要自己堆代码项目周期一长界面逻辑和业务逻辑纠缠在一起后续维护的代价远高于一开始选对控件。EhLib VCL 恰好是干这个的它在 Delphi 生态里作为“增强版表格与数据感知控件集”存在10.2.42 这个版本号明确支持 12.3 Athens解决的就是“原装网格控件不够用”和“第三方控件装不上”这两类问题。对正在从 D7 往高版本迁移的团队、把 VCL 应用从 Win32 带到 Win64 的工程师以及刚下载 Delphi 12.3 绿色版想在本地搭一套顺手控件的开发者来说装好 EhLib 并把它配置正确比琢磨任何“高级架构”都更能直接提升表格类功能的开发速度。本文按安装、数据组件、数据集操作、典型错误和进阶验证的顺序把 10.2.42 在 Athens 上的使用边界讲清楚。2. 装进 Delphi 12.3 Athens解压路径、lib 目录与 IDE 注册2.1 先搞懂 EhLib 的目录结构里有什么拿到EhLib VCL 10.2.42 for Delphi 12 Athens.7z之后第一件事不是双击安装程序而是注意它的形态这是一个压缩包不是 exe 安装包。这个细节很关键因为很多团队习惯了“一路 Next”的组件安装方式碰到手动解压的包就不知道下一步做什么。解压后你会看到大致结构Lib目录按 Win32/Win64 分列 .dcu、.bpl、.res 等文件、Source目录部分版本保留 .pas 源文件方便调试时跟踪控件内部逻辑、Samples目录带示例项目建议保留、Docs目录含 HTML 帮助或 PDF含属性参考。重点在于Lib目录。10.2.42 针对 Athens 编译的 dcu 和 bpl 都放在这里你的 IDE 必须精确指向这一层否则会出现“找到源文件但找不到编译产物”的错位。提示如果你下载的是所谓“Delphi 12.3 绿色版”而非官方安装版IDE 对库路径的搜索顺序会有差异建议优先把 EhLib 的路径放在 Tools Options Library 列表的靠前位置减少被同名文件干扰的可能。2.2 手动注册 bpl 包的完整流程虽然各版本细节略有差异但 VCL 控件安装的标准路径依然是“先编译包再安装包”。打开你的 Delphi 12.3 Athens按以下步骤去操作。2.2.1 打开并编译设计期包进入Lib目录找到类似EhLib120.bpk或dclEhLib120.bpk的工程文件。dcl前缀表示设计期包Design-Time Package运行时包通常不带前缀。操作顺序为// 以下不是代码而是 IDE 操作序列 1. File Open选择 dclEhLib120.bpk 2. Project Manager 窗口中右键该包选择 Compile 3. 编译成功后右键选择 Install编译这一步常见的失败原因是路径不对。如果 IDE 报找不到某个 .dcu先去Tools Options Library Library paths里添加解压后的根目录和Lib\Win32或Lib\Win64目录。添加后重开 Project Manager再编译通常就能通过。2.2.2 确认 IDE 菜单里出现 EhLib 分页安装成功后组件面板上会多出一个或几个带 EhLib 字样的标签页里面有TDBGridEh、TDBEditEh、TDBLookupComboboxEh等组件。看到它们说明运行时包和设计期包都正常注册了。如果你用的绿色版缺少某些注册表项组件面板可能不刷新。此时在 IDE 里执行Component Install Packages点击 Add手动选中刚才编译生成的dclEhLib120.bpl文件确定后即可强制加载。2.3 安装失败时你最需要看的三个信号安装阶段最容易踩的坑集中在三个信号上第一个信号是Package ... is not found。这往往是 bpl 文件所在目录不在系统 PATH 中导致的。把Lib\Win32或Lib\Win64加到系统环境变量 PATH 中并完全重启 Delphi即可解决。第二个信号是Cannot load package ...。这通常意味着运行时包和设计期包版本不匹配例如你编译了运行时包但安装的是旧的设计期包。回到Lib目录把同批次的 .bpl 全部拷到同一目录再做安装。第三个信号是 IDE 崩溃或启动时弹错误框。多数情况是不同版本的 EhLib 残留在注册表里。打开注册表编辑器定位到HKEY_CURRENT_USER\Software\Embarcadero\BDS\23.0\Known PackagesAthens 的 BDS 版本号以实际为准把含 EhLib 的旧条目删掉再重新安装。注意在安装过程中如果出现“SQLite 乱码”类的问题先不要怀疑 EhLib 的编码支持而应在后面配置数据集时检查VCLUnicode相关属性这一步通常会暴露真正的字符转换边界。3. 数据感知组件实战从 DBGridEh 到 EditEh 的属性地图3.1 DBGridEh 不是“换皮 DBGrid”很多人把TDBGridEh当作 DBGrid 的皮肤版只为了加个斑马纹或行号这是极大的浪费。EhLib 真正值钱的地方在于列的构建方式、数据呈现逻辑以及和数据集交互的行为控制。先看最常用的列设置。在设计期双击 DBGridEh打开列编辑器添加几列并设置关键属性// 列属性关键配置示例在设计期 Object Inspector 中操作 DBGridEh1.Columns[0].FieldName : OrderNo; DBGridEh1.Columns[0].Title.Caption : 订单号; DBGridEh1.Columns[0].Width : 120; DBGridEh1.Columns[0].Title.TitleButton : True; DBGridEh1.Columns[1].FieldName : OrderDate; DBGridEh1.Columns[1].Title.Caption : 下单日期; DBGridEh1.Columns[1].Width : 130; DBGridEh1.Columns[1].DisplayFormat : yyyy-mm-dd;这里的TitleButton置为 True 后网格标题可以点击排序。但真正的排序逻辑并不由网格独自完成它需要通过事件去驱动数据集排序否则只是视觉上有个“排序箭头”而数据纹丝不动。常用的做法是在TitleBtnClick事件里调用TDataSet的排序方法。下拉列表和数据绑定是 DBGridEh 的另一大杀器。使用TDBLookupComboboxEh作为列的 InPlaceEditor 时你不需要额外放一个查询组件直接在列里指定LookupDataField和KeyField即可// 设置某列为下拉选择 DBGridEh1.Columns[2].FieldName : CustomerID; DBGridEh1.Columns[2].DropDownShow : True; // 在设计期指定 Columns[2].LookupParams 关联到客户表这个思路比手工弹窗体选值要简洁得多因为它完全在网格内部完成数据展示和编辑的联动并且能保留数据库外键的原始值而不是把显示文本写回数据集。3.2 EditEh 与 SpinEditEh 的输入收敛表格场景里用户输入常常是错误高发区。日期格式不对、数字带逗号、字符串前后空格这些都能在数据校验环节消耗大量时间。EhLib 的TDBEditEh通过EditMask和ValueChecked/ValueUnchecked属性把所有校验前移到了控件层。// 金额输入框只允许数字和点 DBEditEh1.EditMask : 999999.99; // 相当于三位小数但更精确的做法 DBEditEh1.DisplayFormat : 0.00; DBEditEh1.EditFormat : 0.00;DisplayFormat和EditFormat的分离是一个值得注意的设计点。显示时自动补小数点后两位编辑时按用户输入原样显示这能避免“编辑时看得到格式符反而容易输错”的体验问题。TSpinEditEh适合数量类输入。它的一个被低估的属性是MaxValue和MinValue很多人以为这只是界面上按钮的边界实际它会在输入非法值时自动拒绝不需要在 AfterPost 中再判断一次。3.3 表格控件在“只读报表”场景下的属性收敛表格控件不只是用于编辑更常见的场景是只读报表。此时建议把 DataGrouping 和行高设置结合起来用。例如按状态字段分组显示// 启用数据分组 DBGridEh1.DataGrouping.Active : True; DBGridEh1.DataGrouping.GroupLevels.Clear; DBGridEh1.DataGrouping.GroupLevels.Add.FieldName : Status; DBGridEh1.DataGrouping.GroupLevels[0].FooterText : 组内记录数; DBGridEh1.DataGrouping.GroupLevels[0].FooterValueType : fvtCount;这里的FooterValueType : fvtCount是分组统计的快速入口它自动计算每组行数避免你在 SQL 里写COUNT(*) OVER(PARTITION BY ...)。对 5 年以上 Delphi 经验的工程师来说这可以省掉一批原本要交给 SQL 的轻量统计需求。4. 数据集操作边界排序、过滤与“cannot perform this operation on an open dataset”4.1 为什么你会遇上 “cannot perform this operation on an open dataset”在 Delphi 12.3 Athens 上使用 EhLib 时搜索关联度最高的报错之一就是cannot perform this operation on an open dataset。很多人第一反应是组件 Bug其实这个错误来自 VCL 本身的TDataSet保护机制而不是 EhLib 的缺陷。它意味着你的代码在数据集已经打开的情况下执行了要求数据集处于关闭状态的操作典型例子是在运行时修改DataSource.DataSet.CommandText、重新赋值TableName或调用某些需要重建游标的函数。常见触发场景是这样的// 错误示例数据集已打开又尝试设 CommandText with ADODataSet1 do begin if Active then Close; // 必须主动关闭 CommandText : SELECT * FROM Orders; Open; end;EhLib 的组件在感知数据集结构变化时会触发内部元数据刷新如果底层数据集状态不对就很容易把这个错误提前引爆。而正确做法是在修改任何定义数据结构的属性之前保证数据集处于关闭状态。4.2 运行时排序与过滤的标准写法EhLib 的排序和过滤能力依赖数据集的游标定位但它的DBGridEh.SortMarkedColumns机制和 TClientDataSet 的IndexFieldNames配合尤其顺滑。以下是一段可复用的排序模板procedure TForm1.DBGridEh1TitleBtnClick(Sender: TObject; ACol: Integer; Column: TColumnEh); var FieldName: string; begin FieldName : Column.FieldName; if FieldName then Exit; with ClientDataSet1 do begin if Active then Close; IndexFieldNames : FieldName; Open; end; end;注意Close之后再Open这个动作它是规避“open dataset”错误的最直接手段。在数据量达到十万行以上时这种重建索引的代价可能达到几百毫秒用户体感会很差。这时可以把IndexFieldNames换成TClientDataSet的IndexName预先建立好持久化索引修改IndexName不需要关闭数据集。过滤方面EhLib 提供DBGridEh.STFilter的局部过滤但它最终要落到数据集的Filter或OnFilterRecord上。推荐使用TDataSet.Filter配合Filtered : True因为这种方式可以保留滚动状态不会重置游标。// 设置网格过滤条件 DBGridEh1.STFilter.Local : True; DBGridEh1.STFilter.Visibility : [fvNonEmpty]; DBGridEh1.STFilter.FilterOnTyping : True; // 实际生效仍然需要数据集 Filter ClientDataSet1.Filter : Status QuotedStr(Paid); ClientDataSet1.Filtered : True;FilterOnTyping : True的代价是每次按键都可能触发数据集刷新如果数据源是远程数据库建议设置为 False只在用户按回车时联动刷新。4.3 TreeViewEh 与关系型数据的层次展示关系数据的树形展示是 TDBGridEh 本身覆盖不到的EhLib 提供TTreeViewEh来解决。它和 VCL 自带 TTreeView 最大的区别是它可以绑定到一个带有父子关系字段的 DataSet并自动维护节点的展开状态。设置方式为TreeViewEh1.DataSource : DataSource1; // 数据源 TreeViewEh1.KeyField : ID; TreeViewEh1.RefParentField : ParentID; TreeViewEh1.RefTextField : Name; TreeViewEh1.TreeMode : True;TreeMode开启后节点层级由RefParentField的递归关系决定你不再需要手工循环插入节点这对于“部门-子部门”“分类-子分类”这类结构是很明显的效率提升。常见的误用是在 TreeViewEh 上同时启用DataSource和手动AddChild逻辑这会导致节点重复、展开状态错乱。二选一要么让数据驱动要么走纯手工构建节点混用是排错时最难收拾的局面。5. 进阶验证在 12.3 上批量压测 DBGridEh 渲染与内存表场景5.1 用虚拟数据集跑一遍百万行渲染在宽带和内存都足够的情况下EhLib 在大数据量下的表现主要取决于数据集读取模式和网格的绘制策略。这里给一个可复现的最小化压测方案用 TClientDDataSet 在内存中生成假数据然后观察滚动和绘制的帧率。procedure TForm1.GenerateData; var i: Integer; begin ClientDataSet1.CreateDataSet; ClientDataSet1.DisableControls; try for i : 1 to 100000 do begin ClientDataSet1.Append; ClientDataSet1.FieldByName(ID).AsInteger : i; ClientDataSet1.FieldByName(Name).AsString : Name_ IntToStr(i); ClientDataSet1.FieldByName(Amount).AsFloat : i * 1.5; ClientDataSet1.Post; end; finally ClientDataSet1.EnableControls; end; end;这段代码的关键在于DisableControls它停止网格在每次数据变更时的逐行刷新让数据插入速度提升一个数量级。注意它的副作用在禁用控制期间用户界面不会显示滚动进度如果你的界面需要实时反馈就不要在大循环里使用。接下来针对渲染做优化。在 DBGridEh 属性中HorzScrollBar和VertScrollBar的Tracking若为 True则在滚动过程中会实时绘制全部可见记录这会让老机器卡顿建议在数据量大的场景设为 False只在滚动停止后刷新画面。5.2 一个容易被忽略的验证技巧用 Stopwatch 测 ActualCountEhLib 的全部表格组件都有DataSource.DataSet.RecordCount可用但有些数据集类型如TFDQuery是异步获取的直接读 RecordCount 会触发完整的数据集加载性能反而更差。此时用DBGridEh.DataGrouping的分组统计量可以避免全表扫描。还可尝试准则如果你怀疑是网格绘制拖慢了界面在主窗体 OnKeyUp 中临时切换DBGridEh1.OptionsEh里的dghExtendVertLines和dghTraceColSizing如果切换后滚动明显变快说明你的机器在抗锯齿线和列分割绘制上吃掉了大部分帧时间。// 临时关闭网格垂直辅助线用于定位绘制瓶颈 DBGridEh1.OptionsEh : DBGridEh1.OptionsEh - [dghExtendVertLines]; DBGridEh1.Invalidate;这里Invalidate是必要的否则界面不会立即反映属性变化。5.3 和 UniGUI 的边界什么场景不该用 EhLib搜索热词里出现了unigui for delphi下载这里需要明确一个边界EhLib 是 VCL 控件它的运行环境是 Windows 桌面应用。如果你要把业务系统搬到浏览器上EhLib 的网格组件不能直接跨到 UniGUI 里。UniGUI 有自己的一套基于 ExtJS 的表格体系两者在数据绑定模式、事件模型、渲染方式上完全不同。如果团队确实需要 Web 化比较务实的方式是保留现有 VCL 业务逻辑层把界面层重写为 UniGUI 的 TUniDBGrid。强行在 UniGUI 中嵌入 VCL 窗口宿主不仅性能差而且会在焦点处理、滚动条、弹窗层级等细节上浪费大量调试时间。这条经验适用于所有 VCL 控件不只 EhLib。结尾处给出一个可落地的判据评估现有页面里如果 70% 以上交互是“看表格、筛选、编辑单行”UniGUI 重写成本可控反之如果有大量复杂的行合并、表头分组、就地统计建议保留桌面版 VCL 应用或者干脆考虑其他成熟 Web 前端方案。EhLib 10.2.42 在 Athens 上的价值正是在它把桌面端这些复杂交互做到极致Web 端则需要另寻出路。本文还有配套的精品资源点击获取