sgcGrid,Delphi 的数据感知 DBGrid 替代品
sgcGrid 是一个数据感知的 Delphi 表格,可绑定到你的 DBGrid 已在使用的 TDataSet,然后对同样的行进行分组、合计、筛选和导出。
sgcGrid 是一个数据感知的 Delphi 表格,可绑定到你的 DBGrid 已在使用的 TDataSet,然后对同样的行进行分组、合计、筛选和导出。
你的数据库代码照常工作。只有表格以及表格与数据集之间的连接会改变。
sgcGrid 可绑定到 FireDAC 的 TFDQuery、TClientDataSet 或任何其他数据集。在 TDBGrid 所显示内容的基础上,它还能对行进行分组和合计,通过筛选行、列筛选和查找面板进行筛选,导出到 Excel,并就地更新变化的行,适用于 VCL 和 FireMonkey。
TDBGrid 通过 TDataSource 读取其数据集。在 sgcGrid 中,由 TsgcGridSource_DataSet 代替 TDataSource:设置它的 Grid 和 DataSet,将它设为 Active,行就会出现。数据集可以是 FireDAC 查询、TClientDataSet 或任何其他 TDataSet 的子类。
KeyField 后,表格会同步而不是重新加载:变化的行就地更新并闪烁,新的键被追加,缺失的键被删除。LiveUpdates 使表格跟随数据集的每一次 Post、Delete 和 Refresh。AutoColumns 会根据字段创建列。已设计的列会保留,并按 FieldName 匹配。DisableControls,并会恢复其当前记录。关闭数据集后,行仍然保留。BooleanFields 会将以文本或数字存储的标志(例如 S 和 N)显示为复选框。uses
SysUtils, Classes, DB, FireDAC.Comp.Client,
sgcUICore_Canvas, sgcUICore_Theme, sgcUICore_Table, sgcGrid_Columns,
sgcGrid_Data, sgcGrid_Format, sgcGrid_Render, sgcGrid_IO,
sgcGrid_Source_DataSet, sgcGrid_XLSX, sgcGrid_VCL;
procedure TOrdersForm.FormCreate(Sender: TObject);
begin
// the query that fed the TDBGrid stays as it is
qryOrders.Open;
// TsgcGridSource_DataSet takes the place of the TDataSource
FSource := TsgcGridSource_DataSet.Create(Self);
FSource.Grid := sgcVCLGrid1;
FSource.DataSet := qryOrders;
FSource.KeyField := 'ID'; // changed rows update in place
FSource.AutoColumns := True; // columns from the fields
FSource.LiveUpdates := True; // follow Post, Delete and Refresh
FSource.Active := True;
end;
数据源是一个组件,因此同样的绑定可以放在窗体文件中,并在对象检查器中设置:
object SourceDB: TsgcGridSource_DataSet
DataSet = cdsProducts
Grid = GridDB
KeyField = 'ID'
end
同一个数据源可用相同的代码绑定 FireMonkey 的 TsgcFMXGrid。绑定、分组、汇总和筛选属于每个版本,包括免费的 Delphi Community 版本。
行来自数据集;分组、汇总、筛选和导出在表格中运行。
GroupBy,也可将表头拖到分组面板SummaryType 设置OnApplySort 会以字段名的形式传递排序,例如用于 FireDAC 查询的 IndexFieldNamesSaveToXLSX 无需外部库即可写出 Excel 工作簿,分组为可折叠的大纲,分组合计为 SUBTOTAL 公式(Registered 版本)
行更新时变化的单元格会闪烁。
两级分组、明细行和着色单元格。
先筛选,再按多列排序。
通过 TsgcGridSource_DataSet 绑定到 TClientDataSet。
procedure TOrdersForm.SetupGrid;
begin
// group by region; users drag more columns to the group panel
sgcVCLGrid1.ShowGroupPanel := True;
sgcVCLGrid1.GroupBy(['Region']);
// totals in the footer and in every group row
sgcVCLGrid1.Columns.FindByField('Amount').SummaryType := gsuSum;
sgcVCLGrid1.Columns.FindByField('ID').SummaryType := gsuCount;
sgcVCLGrid1.ShowFooter := True;
// a filter row under the header and the find panel
sgcVCLGrid1.ShowFilterRow := True;
sgcVCLGrid1.ShowFindPanel := True;
end;
procedure TOrdersForm.btnExcelClick(Sender: TObject);
begin
// Registered edition: the sheet keeps the groups and the totals
sgcVCLGrid1.SaveToXLSX('orders.xlsx', 'Orders');
end;
标准的 VCL TDBGrid 用于显示和编辑数据集。下表列出了每个表格无需额外代码即可实现的功能。
| 功能 | TDBGrid | sgcGrid | sgcGrid 版本 |
|---|---|---|---|
| 绑定 TDataSet | 通过 TDataSource | TsgcGridSource_DataSet,设置 DataSet、Grid 和 KeyField | 全部 |
| 设计的列 | TColumn 的 Columns | 按 FieldName 匹配的 Columns,或 AutoColumns | 全部 |
| 变化的行就地更新,并带闪烁效果 | No | 是,通过 KeyField | 全部 |
| 点击表头排序 | 需在 OnTitleClick 中编写代码 | 内置,数据集使用 OnApplySort | 全部 |
| 分组与分组面板 | No | GroupBy, ShowGroupPanel | 全部 |
| 页脚与分组汇总 | No | SummaryType gsuSum、gsuCount、gsuAverage、gsuMin、gsuMax | 全部 |
| 筛选行与列筛选 | No | ShowFilterRow, ShowFilterButtons | 全部 |
| 查找面板 | No | ShowFindPanel, FindOnlyMatches | 全部 |
| 分带、最佳适配与已保存的布局 | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | 全部 |
| 无需绘制代码即可按单元格着色 | 需在 OnDrawColumnCell 中编写代码 | FormatRules、OnGetCellStyle,自定义绘制使用 OnCustomDrawCell | 全部 |
| 多行选择 | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow、GetSelectedKeys | 全部 |
| 编辑并提交到数据集 | 是,使用 dgEditing | WriteBack 会将每次编辑提交到对应记录,SyncCursor 使当前记录保持同步 | Registered |
| Excel 导出 | No | SaveToXLSX,可保存到文件或流 | Registered |
| 过大而无法加载的表 | No | 使用 TsgcGridServerProvider_DataSet 的服务器模式,一次一页 | Registered |
| FireMonkey | 否,仅限 VCL | Windows、macOS、iOS 和 Android 上的 TsgcFMXGrid | 全部 |
| .NET | No | WinForms、WPF 和 Avalonia 表格 | 全部 |
请参阅完整的 sgcGrid 功能对比表、基准测试和 sgcGrid 对比。
启用 WriteBack 后,数据源会将表格中的每次编辑写入对应行的记录。它通过 KeyField 定位记录并提交值。当提交失败时(例如 BeforePost 检查未通过),该记录会被取消,单元格保留其旧值。
SyncCursor 使当前记录与焦点行保持一致,因此同一数据集上的 TDBNavigator 和 TDBEdit 控件会跟随表格,表格也会跟随它们AllowInsert:按 Ins 会追加并提交一条记录,数据集的 OnNewRecord 负责填充默认值ApplyFilter 使数据集只保留表格所显示的行,因此其上的数据感知控件和报表看到的是筛选后的行WriteBack、SyncCursor、插入、删除、粘贴和撤销属于 Registered 版本。试用版包含这些功能,供评估使用。
阅读 DataSet 编辑帮助主题三个步骤:在设计时导入列,替换属性和事件,删除 DB 表格。数据仍然保留在同一个 TDataSet 中。
TsgcVCLGrid。TsgcGridSource_DataSet,复制边界(Parent、Align、Anchors、TabOrder 等),复制事件处理程序,并先清除表格的列。导入会复制 FieldName、将 Title.Caption 复制到 Caption、Width(使用窗体的 PixelsPerInch 转换为 DIP)、Visible、Alignment、将 ReadOnly 复制到 Editable,以及 PickList。在代码中,单元 sgcGrid_Import_VCL 里的 sgcGridImportDBGrid 可在运行时完成同样的操作。
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid(单元 sgcGrid_VCL) |
| DataSource | TsgcGridSource_DataSet:DataSet、Grid、KeyField,然后 Active := True(单元 sgcGrid_Source_DataSet) |
| Columns、TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly、Options dgEditing | 表格的 ReadOnly 和数据源的 WriteBack(Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect、SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator],另有 grhNumbers 和 grhCheckBox |
| dgColLines、dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell;仅需着色时,使用 OnGetCellStyle 或 FormatRules |
| OnTitleClick | OnHeaderClick;表格自动排序 |
| OnColEnter、OnColExit | OnSelectionChange,配合 SelectedCol |
TDBGrid 迁移套件提供完整的成员对照表、来自 MigrateFromDBGrid 演示的迁移前后代码(可在 Delphi 7 和 Delphi 13 下编译,Win32 和 Win64),以及已知的差异。其他迁移套件见 sgcUI 迁移页面。
同一个表格模型同时驱动 VCL 和 FireMonkey 表格,因此 VCL 窗体和 FireMonkey 窗体可共用绑定代码。
| 目标 | 组件 | 平台 |
|---|---|---|
| Delphi 7 到 13,VCL | TsgcVCLGrid | Win32,以及自 XE2 起的 Win64 |
| Delphi XE6 到 13,FireMonkey | TsgcFMXGrid | Windows、macOS、iOS 和 Android |
| C++ Builder 2007 到 13 | TsgcVCLGrid、TsgcFMXGrid | 生成的 .hpp 头文件和静态库 |
| .NET Framework 4.7.2、.NET 8、9 和 10 | TsgcWinFormsGrid、WPF 和 Avalonia 表格 | WinForms、WPF、Avalonia |
TDBGrid 列的导入在 VCL 窗体设计器中运行。FireMonkey 窗体使用同一个 TsgcGridSource_DataSet 绑定数据集。
DataSet 绑定(设计的列按 FieldName 匹配)、查阅字段、单元格、行和多行选择、行头、自定义绘制、Ctrl+C、分组面板、页脚和分组汇总、筛选行、Excel 风格的列筛选、查找面板、分带、最佳适配,以及 JSON 布局的保存和加载。免费的 Delphi Community 版本包含 sgcGrid。
对数据集的双向编辑(WriteBack)、光标同步(SyncCursor)、插入、删除、粘贴和撤销、Excel 导出、卡片视图,以及适用于超大表的服务器模式。sgcGrid 可单独购买,提供 Single、Team 和 Site 许可证及完整源代码,并包含在 sgcUI Standard、Professional、Enterprise 和 All-Access 中。
查看 sgcGrid 价格或下载试用版,试用版包含所有 Registered 功能,供评估使用。
在 TDBGrid 旁边放置一个 TsgcVCLGrid,右键单击它并选择从 DB 表格导入列。导入会复制列,创建一个链接到同一数据集的 TsgcGridSource_DataSet,复制边界和事件处理程序,并报告需要手动移植的事件。然后删除 TDBGrid。迁移套件对照列出了每个属性和事件。
TDBGrid 是 VCL 控件。sgcGrid 提供 FireMonkey 表格 TsgcFMXGrid,适用于 Windows、macOS、iOS 和 Android 上的 Delphi XE6 到 13,同一个 TsgcGridSource_DataSet 可用与 VCL 表格相同的代码将它绑定到任意 TDataSet。
可以。使用字段名调用 GroupBy,或让用户将列表头拖到分组面板。在列上设置 SummaryType(sum、count、average、minimum 或 maximum)并开启 ShowFooter:合计会显示在页脚和每个分组行中。分组和汇总属于每个版本,包括 Community。
将数据集绑定到 sgcGrid,并使用文件名或流调用 SaveToXLSX。工作簿无需外部库,并保留用户所见的内容:按显示顺序排列的可见列及其宽度和数字格式、冻结的表头、作为可折叠大纲的分组,以及作为 SUBTOTAL 公式的分组合计。Excel 导出属于 Registered 版本;Community 版本可导出 JSON 和 CSV。
能。TFDQuery 或 TFDTable 就是 TDataSet,因此 TsgcGridSource_DataSet 可像绑定 TClientDataSet 一样绑定它。OnApplySort 会以 FireDAC IndexFieldNames 的形式传递表格的排序,例如 Name;Date:D。对于过大而无法加载的表,使用 TsgcGridServerProvider_DataSet 的服务器模式(Registered)一次读取一页,并由数据库通过 SQL 完成排序、筛选、计数和分组,SQL 由 FireDAC 或其他查询组件执行。
可以,需要 Registered 版本。使用 WriteBack 时,数据源会将每次编辑提交到对应行的记录(通过 KeyField 定位),SyncCursor 使当前记录与焦点行保持一致,因此同一数据集上的 TDBNavigator 和 TDBEdit 控件会保持同步。在 Community 版本中,表格以只读方式显示数据集。