sgcPivotGrid 功能矩阵
按任务分类的 sgcPivotGrid 全部功能，每项功能都链接到对应的帮助主题。引擎 TsgcPivotEngine 也可在没有窗口的情况下工作。
按任务分类的 sgcPivotGrid 全部功能，每项功能都链接到对应的帮助主题。引擎 TsgcPivotEngine 也可在没有窗口的情况下工作。
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 百万行 | 类型化列存储、每次重新计算只遍历一遍，以及虚拟绘制。MillionRows 演示对 1,000,000 行进行透视。 | 帮助 | |
| 异步计算 | AsyncCalculation 或 RecalculateAsync（在 .NET 中是带 CancellationToken 的 Task<bool>）在后台线程中重新计算，CancelCalculation 让上一次的结果继续显示，OnCalculated 在 UI 线程上触发。 | 注册版 | 帮助 |
| 批量加载 | BeginLoad、DefineColumn、AppendRow 和 EndLoad，以及用于一次重新计算的 BeginUpdate 和 EndUpdate。 | 帮助 | |
| 数据源 | TsgcPivotSource_DataSet 跟随 TDataSet 并支持实时更新，Throttle 会把快速变化合并为一次重新计算；TsgcPivotSource_Table 读取 sgcGrid 或任意 IsgcUITable。 | 帮助 | |
| ItemsSource 绑定 (.NET) | TsgcWpfPivotGrid 和 TsgcAvaloniaPivotGrid 从 ItemsSource（任意 IEnumerable）读取源行，并在集合或某个项目变化时重新计算。在 WPF 中，ICollectionView 的筛选决定哪些项目成为行。TsgcWinFormsPivotGrid 读取 DataSource 和 DataMember，BindingSource 的筛选会作用到数据透视表。绑定是单向的：数据透视表从不向数据写入。 | 帮助 | |
| XAML 与设计器中的字段 (.NET) | TsgcWpfPivotField 和 TsgcAvaloniaPivotField 元素用 FieldName、Area、Aggregation 和 DisplayFormat 声明字段，字段列表通过其 PivotGrid 属性绑定到对应的网格。在 WinForms 中，Visual Studio 设计器通过智能标记和集合编辑器编辑 Fields，没有字段的数据透视表会在设计器以及 WPF 和 Avalonia 预览器中显示示例数据透视表。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 日期分组 | 对同一日期字段按年、季度、月、周和日分组。 | 帮助 | |
| 展开与折叠 | ExpandAll、CollapseAll 和 ExpandLevel。 | 帮助 | |
| 八种聚合 | 求和、计数、平均值、最小值、最大值、CountDistinct、StdDev 和 Var。 | 帮助 | |
| 合计 | 按轴提供小计和总计，可设置其位置（SubtotalPosition）和标题（GrandTotalCaption）。 | 帮助 | |
| 排序 | 按标签或度量值对成员排序（SortBy、SortMeasure、SortOrder）。 | 帮助 | |
| 筛选 | 带 13 种运算符的标签和值筛选，以及字段列表中的成员复选列表。 | 帮助 | |
| 计算字段 | 支持 IF、ROUND、MIN、MAX、ISNULL、YEAR 和 MONTH 的行级表达式（TsgcPivotCalculatedField），像源列一样进行聚合。 | 注册版 | 帮助 |
| 计算项 | Field.CalculatedItems.Add(Name, Formula) 通过对同级项的公式（如 East+West 或 Q1-Q2）向行字段或列字段添加成员。它排在真实成员之后，合计仍以源行为基础，布局 JSON 会保存它。 | 注册版 | 帮助 |
| 值显示方式 | 占行、列或总计的百分比、累计、差异和排名。 | 注册版 | 帮助 |
| 带“其他”的 Top N | TopN 保留总计最大的成员，TopNOthers 将其余成员合并为“其他”行。 | 注册版 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 字段列表 | 用户可在行、列、筛选和数据之间拖动字段。 | 帮助 | |
| 字段按钮 | 设置 Layout = pvlBar 后，字段列表变成数据透视图上方的字段按钮栏：Filters、Columns（图例）、Rows（坐标轴）和 Values。拖动按钮可移动字段，用漏斗筛选其成员，也可通过菜单展开、折叠和删除字段。 | 注册版 | 帮助 |
| 条件格式 | 诸如色阶之类的格式规则（TsgcPivotFormatRule、pvrColorScale）。 | 帮助 | |
| 下钻 | 双击或按 Enter 可显示单元格背后的源数据行（OnDrillDown、DrillDown、GetSourceRows）。 | 帮助 | |
| 键盘 | 数据透视表中的键盘导航。 | 帮助 | |
| 主题 | 浅色和深色主题：Theme := utDark。 | 帮助 | |
| 从右到左（阿拉伯语和希伯来语） | 行标题区域、列标题顺序、紧凑缩进、展开箭头、字段列表和滚动条均已镜像，XLSX 导出会写出从右到左的工作表。数字保持从左到右。 | 帮助 | |
| 无障碍 | 作为带有可展开和折叠的行标题和列标题、数据单元格和总计的表格向 UI Automation 公开，字段列表按区域公开为字段列表。Ctrl+1 到 Ctrl+4、Ctrl+Up、Ctrl+Down、Space 和 Del 用键盘移动字段，焦点环始终可见，并遵循 Windows 高对比度。默认开启，可用于 VCL（Delphi 7 到 13）、Windows 上的 FireMonkey、WinForms、WPF 和 Avalonia。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 导出 | SaveToCSV、SaveToJSON、SaveToHTML、SaveToPNG 和 SaveToSVG。 | 帮助 | |
| 导出为 Excel (XLSX) | 引擎以及 VCL、FireMonkey、WinForms、WPF 和 Avalonia 网格上的 SaveToXLSX 无需外部库即可写出工作簿：合并的列标题、加粗的合计、分级显示行、冻结的标题行、Excel 数字格式和 Excel 百分比。 | 注册版 | 帮助 |
| 布局持久化 | SaveLayoutToFile 和 LoadLayoutFromFile 以 JSON 形式存储布局，其中包括数据透视图的设置。 | 注册版 | 帮助 |
| 无界面渲染 | 服务器或 Linux64 上的 TsgcPivotGridRenderer。 | 帮助 | |
| 图表互操作 | sgcCharts 可将透视结果作为表格读取。 | 帮助 | |
| 透视图表链接 | sgcCharts 的 TsgcChartTableLink 把图表绑定到透视结果：每个值列一个系列，行标签作为类别。支持柱形、堆积柱形、折线和面积图，透视表变化时重建，保留系列颜色。适用于 sgcCharts 的每个版本，也适用于 sgcGrid。 | 帮助 | |
| 数据透视图 | TsgcPivotChartTable 为 sgcCharts 的 TsgcChartTableLink 提供数据：簇状、堆积和百分比堆积柱形图、折线图、面积图、饼图、圆环图，以及带次坐标轴的组合图，还有总计、前 N 项和数据标签。图表设计器通过数据页设置它，布局 JSON 的 charts 成员保存它，Delphi 和 .NET 完全一致。需要注册版的 sgcCharts。 | 注册版 | 帮助 |
| 向透视表提问 | TsgcPivotGridAI 通过任意 AI 提供程序，将“销售额前三的国家”这样的问题转换为数据透视表布局，适用于 VCL、FireMonkey、WinForms、WPF 和 Avalonia，可使用 AI 查询栏，也可通过代码调用。只发送问题和字段目录，绝不发送行数据。在注册版中，撤销可恢复之前的布局。 | 帮助 | |
| sgcWebSockets AI 提供程序 | sgcPivotGridWS 桥接的 TsgcPivotGridAIQuery 在 Chat 中接收一个 TsgcAIChat。sgcUICoreWS 桥接的 TsgcUIAIChatProvider 在所有平台上使用 sgcWebSockets 的 TsgcAIChat 组件。在 .NET 中使用 esegece.sgcUICore.sgcWebSockets 包。需要已注册的 sgcWebSockets。 | 注册版 | 帮助 |
| 打印和打印预览 | Print 和 ShowPrintPreview 可以按当前布局打印整个数据透视表，在每一页的顶部重复列标题，在左侧重复行标题。PrintSettings 一次性设置纸张、方向、页边距、缩放、页眉和页脚，打印机、预览和 PDF 共用这些设置。所有版本均可使用，支持 VCL、FireMonkey、WinForms、WPF 和 Avalonia（FireMonkey 的打印在 Windows 和 macOS 上可用）。 | 帮助 | |
| 无障碍 PDF 导出，PDF/UA 和 PDF/A（配合 sgcPDF） | ExportToPDF 写出带可搜索文本的矢量页面，每一页都是带列标题和行标题单元格的真正表格，被缩短的标签也为屏幕阅读器保留完整文本。文件默认是带标签的 PDF/UA 文档，PDFALevel 可再加上 PDF/A-2a 或 PDF/A-3a。需要 sgcUIPDF 桥接和已获许可的 sgcPDF（在 .NET 中为 esegece.sgcUICore.sgcPDF）。 | 注册版 | 帮助 |
.NET 数据透视表是 C# 移植版本而非封装，适用于 WinForms、WPF 和 Avalonia，共享同一引擎，支持无界面 PNG 和 SVG 以及 DataTable 数据源。
| 包 | 版本 | 内容 |
|---|---|---|
esegece.sgcPivotGrid.Community | 社区版（免费） | 核心库 |
esegece.sgcPivotGrid.WinForms.Community | 社区版（免费） | Windows Forms 控件 |
esegece.sgcPivotGrid.Wpf.Community | 社区版（免费） | WPF 控件 |
esegece.sgcPivotGrid.Avalonia.Community | 社区版（免费） | Avalonia 控件 |
esegece.sgcPivotGrid.Rendering.Community | 社区版（免费） | 无头渲染 |
esegece.sgcPivotGrid | 注册版 | 核心库 |
esegece.sgcPivotGrid.WinForms | 注册版 | Windows Forms 控件 |
esegece.sgcPivotGrid.Wpf | 注册版 | WPF 控件 |
esegece.sgcPivotGrid.Avalonia | 注册版 | Avalonia 控件 |
esegece.sgcPivotGrid.Rendering | 注册版 | 无界面渲染 |
esegece.sgcPivotGrid.sgcWebSockets | 仅限注册版 | sgcWebSockets 桥接 |
esegece.sgcUICore.sgcWebSockets | 仅限注册版 | sgcWebSockets AI 提供程序（TsgcUIAIChatProvider） |
sgcPivotGrid 的每项功能都记录在 sgcUI 帮助中，每种开发环境各有一个版本。