Delphi & C++ Builder VCL 和 FireMonkey

sgcGrid,Delphi 的数据感知 DBGrid 替代品

sgcGrid 是一个数据感知的 Delphi 表格,可绑定到你的 DBGrid 已在使用的 TDataSet,然后对同样的行进行分组、合计、筛选和导出。

带合计的分组
筛选行和查找面板
变化的行就地更新
Excel 导出
任意 TDataSetDelphi 7 到 13FireMonkey 从 XE6 起免费的 Delphi Community 版本

从 TDBGrid 迁移 → · 查看价格 →

Delphi 数据表格按地区对客户分组,每个分组行都有汇总,页脚有合计,旁边是联系人卡片和位置地图,来自 Altamira ERP 演示中的 sgcGrid

将 sgcGrid 绑定到 TDataSet、TFDQuery 或 TClientDataSet

你的数据库代码照常工作。只有表格以及表格与数据集之间的连接会改变。

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)显示为复选框。
Delphi,sgcGrid 中的 FireDAC 查询
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;

数据源是一个组件,因此同样的绑定可以放在窗体文件中,并在对象检查器中设置:

frmMain.dfm
object SourceDB: TsgcGridSource_DataSet
  DataSet = cdsProducts
  Grid = GridDB
  KeyField = 'ID'
end

同一个数据源可用相同的代码绑定 FireMonkey 的 TsgcFMXGrid。绑定、分组、汇总和筛选属于每个版本,包括免费的 Delphi Community 版本。

阅读 DataSet 绑定帮助主题

对同样的行进行分组、合计、筛选和导出

行来自数据集;分组、汇总、筛选和导出在表格中运行。

sgcGrid 中的 100,000 个订单,先按 Region 再按 Category 分组,带分组面板标签和页脚合计

DBGrid 用户的收获

  • 按一个或多个列分组,可在代码中使用 GroupBy,也可将表头拖到分组面板
  • 在页脚和每个分组行中显示合计、计数、平均值、最小值和最大值,通过 SummaryType 设置
  • 筛选行、每列的 Excel 风格筛选,以及可高亮匹配项的查找面板
  • 点击表头即可自动排序,OnApplySort 会以字段名的形式传递排序,例如用于 FireDAC 查询的 IndexFieldNames
  • SaveToXLSX 无需外部库即可写出 Excel 工作簿,分组为可折叠的大纲,分组合计为 SUBTOTAL 公式(Registered 版本)
  • 分带、最佳适配、列选择器,以及以 JSON 保存和加载的列布局
Delphi,分组、合计、筛选和 Excel
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;

TDBGrid 与 sgcGrid 对比

标准的 VCL TDBGrid 用于显示和编辑数据集。下表列出了每个表格无需额外代码即可实现的功能。

功能TDBGridsgcGridsgcGrid 版本
绑定 TDataSet通过 TDataSourceTsgcGridSource_DataSet,设置 DataSet、Grid 和 KeyField全部
设计的列TColumn 的 Columns按 FieldName 匹配的 Columns,或 AutoColumns全部
变化的行就地更新,并带闪烁效果No是,通过 KeyField全部
点击表头排序需在 OnTitleClick 中编写代码内置,数据集使用 OnApplySort全部
分组与分组面板NoGroupBy, ShowGroupPanel全部
页脚与分组汇总NoSummaryType gsuSum、gsuCount、gsuAverage、gsuMin、gsuMax全部
筛选行与列筛选NoShowFilterRow, ShowFilterButtons全部
查找面板NoShowFindPanel, FindOnlyMatches全部
分带、最佳适配与已保存的布局NoBands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout全部
无需绘制代码即可按单元格着色需在 OnDrawColumnCell 中编写代码FormatRules、OnGetCellStyle,自定义绘制使用 OnCustomDrawCell全部
多行选择dgMultiSelect, SelectedRowsSelectionMode gsmMultiRow、GetSelectedKeys全部
编辑并提交到数据集是,使用 dgEditingWriteBack 会将每次编辑提交到对应记录,SyncCursor 使当前记录保持同步Registered
Excel 导出NoSaveToXLSX,可保存到文件或流Registered
过大而无法加载的表No使用 TsgcGridServerProvider_DataSet 的服务器模式,一次一页Registered
FireMonkey否,仅限 VCLWindows、macOS、iOS 和 Android 上的 TsgcFMXGrid全部
.NETNoWinForms、WPF 和 Avalonia 表格全部

请参阅完整的 sgcGrid 功能对比表、基准测试和 sgcGrid 对比。

DataSetEditing 演示:TDBNavigator 和两个 TDBEdit 与表格使用相同的记录,并带有类别查阅列

通过表格编辑数据集

启用 WriteBack 后,数据源会将表格中的每次编辑写入对应行的记录。它通过 KeyField 定位记录并提交值。当提交失败时(例如 BeforePost 检查未通过),该记录会被取消,单元格保留其旧值。

  • SyncCursor 使当前记录与焦点行保持一致,因此同一数据集上的 TDBNavigator 和 TDBEdit 控件会跟随表格,表格也会跟随它们
  • AllowInsert:按 Ins 会追加并提交一条记录,数据集的 OnNewRecord 负责填充默认值
  • ApplyFilter 使数据集只保留表格所显示的行,因此其上的数据感知控件和报表看到的是筛选后的行

WriteBack、SyncCursor、插入、删除、粘贴和撤销属于 Registered 版本。试用版包含这些功能,供评估使用。

阅读 DataSet 编辑帮助主题

如何在 Delphi 中替换 TDBGrid

三个步骤:在设计时导入列,替换属性和事件,删除 DB 表格。数据仍然保留在同一个 TDataSet 中。

  1. 保存窗体,然后在 TDBGrid 旁边放置一个 TsgcVCLGrid。
  2. 右键单击表格,选择从 DB 表格导入列...,然后在列表中选择该 TDBGrid。
  3. 保持四个选项勾选:创建一个链接到 DataSource 数据集的 TsgcGridSource_DataSet,复制边界(Parent、Align、Anchors、TabOrder 等),复制事件处理程序,并先清除表格的列。
  4. 阅读报告。它会列出每个已导入的列,以及每个需要手动移植的事件。
  5. 检查结果,然后删除 TDBGrid,如果没有其他组件使用它的 TDataSource,也一并删除。

导入会复制 FieldName、将 Title.Caption 复制到 Caption、Width(使用窗体的 PixelsPerInch 转换为 DIP)、Visible、Alignment、将 ReadOnly 复制到 Editable,以及 PickList。在代码中,单元 sgcGrid_Import_VCL 里的 sgcGridImportDBGrid 可在运行时完成同样的操作。

TDBGridsgcGrid
TDBGridTsgcVCLGrid(单元 sgcGrid_VCL)
DataSourceTsgcGridSource_DataSet:DataSet、Grid、KeyField,然后 Active := True(单元 sgcGrid_Source_DataSet)
Columns、TColumn.FieldNameColumns, Columns[i].FieldName
ReadOnly、Options dgEditing表格的 ReadOnly 和数据源的 WriteBack(Registered)
dgRowSelectSelectionMode := gsmRow
dgMultiSelect、SelectedRowsSelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys
dgIndicatorRowHeader := [grhIndicator],另有 grhNumbers 和 grhCheckBox
dgColLines、dgRowLinesGridLinesV, GridLinesH
OnDrawColumnCellOnCustomDrawCell;仅需着色时,使用 OnGetCellStyle 或 FormatRules
OnTitleClickOnHeaderClick;表格自动排序
OnColEnter、OnColExitOnSelectionChange,配合 SelectedCol

TDBGrid 迁移套件提供完整的成员对照表、来自 MigrateFromDBGrid 演示的迁移前后代码(可在 Delphi 7 和 Delphi 13 下编译,Win32 和 Win64),以及已知的差异。其他迁移套件见 sgcUI 迁移页面。

VCL、FireMonkey 和 Delphi 版本

同一个表格模型同时驱动 VCL 和 FireMonkey 表格,因此 VCL 窗体和 FireMonkey 窗体可共用绑定代码。

目标组件平台
Delphi 7 到 13,VCLTsgcVCLGridWin32,以及自 XE2 起的 Win64
Delphi XE6 到 13,FireMonkeyTsgcFMXGridWindows、macOS、iOS 和 Android
C++ Builder 2007 到 13TsgcVCLGrid、TsgcFMXGrid生成的 .hpp 头文件和静态库
.NET Framework 4.7.2、.NET 8、9 和 10TsgcWinFormsGrid、WPF 和 Avalonia 表格WinForms、WPF、Avalonia

TDBGrid 列的导入在 VCL 窗体设计器中运行。FireMonkey 窗体使用同一个 TsgcGridSource_DataSet 绑定数据集。

Community 和 Registered

所有版本都有

DataSet 绑定(设计的列按 FieldName 匹配)、查阅字段、单元格、行和多行选择、行头、自定义绘制、Ctrl+C、分组面板、页脚和分组汇总、筛选行、Excel 风格的列筛选、查找面板、分带、最佳适配,以及 JSON 布局的保存和加载。免费的 Delphi Community 版本包含 sgcGrid。

Registered 版本

对数据集的双向编辑(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 版本中,表格以只读方式显示数据集。

超值之选:All-AccesseSeGeCe 全部产品,含高级支持,每年 €1,059 起。
查看 All-Access 价格

将你的 DBGrid 窗体迁移到 sgcGrid

下载试用版,并将 sgcGrid 绑定到你的 Delphi 应用程序已有的数据集。