sgcDashboard 功能矩阵
按任务分类的 sgcDashboard 全部功能，每项功能都链接到对应的帮助主题。
按任务分类的 sgcDashboard 全部功能，每项功能都链接到对应的帮助主题。
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 响应式磁贴网格 | 默认 12 列，每个磁贴有 Col、Row、ColSpan 和 RowSpan，自动流式布局会将 Col 和 Row 为 -1 的磁贴放入第一个空闲位置。 | 帮助 | |
| 磁贴中的任意控件 | 图表、地图、PDF 查看器、报表预览或备注框。Suite 演示承载了 sgcCharts、sgcMaps、sgcPDF 和 sgcReports。 | 帮助 | |
| 拖放与调整大小 | 用户可通过 AllowDrag 和 AllowResize 重新排列仪表板，设为 Locked 的磁贴保持原位。 | 注册版 | 帮助 |
| 保存布局 | SaveLayout、LoadLayout、SaveLayoutToFile 和 LoadLayoutFromFile 以 JSON 形式存储布局。 | 注册版 | 帮助 |
| 磁贴启动器 | TsgcVCLDashboardTileLauncher 和 TsgcFMXDashboardTileLauncher（在 .NET 中为 TsgcWinFormsDashboardTileLauncher、TsgcWpfDashboardTileLauncher 和 TsgcAvaloniaDashboardTileLauncher）显示一个开始界面，四种尺寸（dtsSmall、dtsMedium、dtsWide、dtsLarge）的磁贴以 first fit 方式排布在带标题的分组中。每个磁贴都有 Badge 胶囊、副标题和图像，支持水平或垂直滚动、OnTileClick、跨分组的方向键、Home、End、Enter 和空格键，以及供屏幕阅读器使用的可调用磁贴列表。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 内置磁贴 | ChartTile、GaugeTile、GridTile、PivotTile 和 MapTile 承载连接到数据源的 sgcCharts、sgcGauges、sgcGrid、sgcPivotGrid 或 sgcMaps 控件，并自动填充数据。每个磁贴都需要对应的 sgcUI 产品及其桥接包。在 .NET 中，包括地图磁贴在内的每个磁贴都适用于 WinForms、WPF 和 Avalonia（地图使用 esegece.sgcDashboard.Maps.Wpf 和 esegece.sgcDashboard.Maps.Avalonia）。地图也会显示在仪表板的打印、PDF 和 HTML 输出中。 | 帮助 | |
| 数据源 | TsgcDashboardDataSource 可以用自己的行、TDataSet（.NET 中为 DataTable）或已连接的 IsgcUITable 为任意数量的磁贴提供数据。每个磁贴读取按求和、计数、平均值、最小值或最大值分组并汇总的视图。线程安全。使用 Live 时，数据源会在记录被提交、插入和删除时跟随 DataSet（.NET 中为 DataTable），Throttle 会把快速变化合并为一次刷新，交叉筛选仍然适用于新的行。 | 帮助 | |
| 交叉筛选 | 点击图表数据点、网格单元格、透视表行或地图标记，会筛选数据源的其他磁贴。筛选栏为每个条件显示一个标签，并提供“全部清除”；ShowFilterBar、ClearFilters、OnFilterChanged、CrossFilterSource 和 CrossFilterTarget。 | 注册版 | 帮助 |
| 响应式断点 | Breakpoints 在 1024 DIP 以下切换到 MediumColumns（8），在 600 以下切换到 CompactColumns（4），每个磁贴的 MediumCell 和 CompactCell 可自动或显式指定，并提供 OnBreakpointChanged。 | ~断点可以工作，但社区版没有 SaveLayout，因此不会被保存。 | 帮助 |
| 运行时设计器 | EditMode、AddTile、RemoveTile、Undo 和 Redo（50 步），以及带调色板和属性列表的设计面板，让用户自行搭建仪表板。SaveLayout 会恢复运行时添加的磁贴。 | 注册版 | 帮助 |
| 发布到网页（HTML） | AsHTML、SaveToHTML 和 SaveToHTMLStream 会把仪表板写成一个自包含的 HTML 页面：每个磁贴由打印时使用的同一段代码绘制为 SVG，并放在遵循仪表板断点的 CSS 网格上。HTMLOptions 设置标题、浅色、深色或自动主题、嵌入字体（EmbedFonts），以及页面每隔 RefreshSeconds 秒重新加载的可选 RefreshURL。没有刷新 URL 时，页面不含脚本。每个磁贴都有标题和供屏幕阅读器使用的文本替代。适用于 VCL、FireMonkey、WinForms、WPF 和 Avalonia，Delphi 与 .NET 的输出相同。 | 帮助 | |
| XAML 中的磁贴（.NET） | 在 WPF 和 Avalonia 中，图表、仪表、网格、透视表和地图磁贴在 sgc 前缀下用 XAML 声明（xmlns:sgc="https://www.esegece.com/sgcui"），图表磁贴的 ValueColumns 和网格磁贴的 Columns 在编译的 XAML 中接受 sys:String 项。 | 帮助 | |
| 活动源 | TsgcVCLActivityFeed 和 TsgcFMXActivityFeed 根据 TsgcDashboardActivityModel 显示谁在何时对哪个对象做了什么：最新在前，按天分组，相对时间支持 sgcUI 的 12 种语言，每个参与者的头像和状态来自在线状态模型。FilterActorId、FilterVerb、FilterObjectType 和 FilterText 用于筛选动态，较早的活动按需加载。 | 帮助 | |
| 审核跟踪 | TsgcVCLAuditTrail 和 TsgcFMXAuditTrail 以带条纹的表格显示同一个模型，其行可展开显示每个变化字段的修改前和修改后的值。 | 帮助 | |
| 活动磁贴和审计磁贴 | 类型为 activity 和 audit 的内置磁贴把活动源和审核跟踪放进仪表板，并带有搜索框（ShowSearch）。它们位于设计器调色板中，会随布局保存，且不需要其他产品。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 主题 | Dashboard.Theme := utDark 会作用于磁贴、KPI 卡片和所承载的控件。在 Fluent 主题预设下，仪表板采用 Windows 11 颜色和 Windows 强调色，磁贴圆角来自预设的 RadiusLarge。 | 帮助 | |
| 实时 KPI | WebSocket、MQTT 和 SSE 数据源无需代码即可从 JSON 消息中读取数值并写入 KPI 卡片。需要 sgcWebSockets。 | 注册版 | 帮助 |
| 实时活动 | 每次变化一条 JSON 消息（add、update、remove、snapshot），通过 ApplyMessage 使活动源、审核跟踪及其磁贴保持最新，也可以无需代码，使用 sgcUICoreWS 桥接的 WebSocket、MQTT 和 SSE 实时数据源，它们需要 sgcWebSockets。 | 注册版 | 帮助 |
| 从右到左（阿拉伯语和希伯来语） | 磁贴流向、磁贴标题和 KPI 卡片布局已镜像。趋势箭头和迷你图保持原有方向，KPI 数值仍按从左到右显示，保持可读。 | 帮助 | |
| 打印和打印预览 | Print 和 ShowPrintPreview 可以把整个仪表板打印在一页上，包含所有未隐藏的磁贴，磁贴中的每个 sgcUI 控件都由各自的渲染器绘制。PrintSettings 一次性设置纸张、方向、页边距、缩放、页眉和页脚，打印机、预览和 PDF 共用这些设置。所有版本均可使用，支持 VCL、FireMonkey、WinForms、WPF 和 Avalonia（FireMonkey 的打印在 Windows 和 macOS 上可用）。 | 帮助 | |
| 无障碍 PDF 导出，PDF/UA 和 PDF/A（配合 sgcPDF） | ExportToPDF 把页面写成一张带标签的图片（默认 192 dpi），并附上列出磁贴标题的替代文本。文件默认是带标签的 PDF/UA 文档，PDFALevel 可再加上 PDF/A-2a 或 PDF/A-3a。需要 sgcUIPDF 桥接和已获许可的 sgcPDF（在 .NET 中为 esegece.sgcUICore.sgcPDF）。 | 注册版 | 帮助 |
| 无障碍 | 仪表板、带标题的磁贴、承载的控件以及带有值和趋势的 KPI 卡片向 UI Automation 公开。方向键在磁贴之间移动，Ctrl+Shift+方向键移动磁贴，Alt+Shift+方向键调整其大小，焦点环始终可见，并遵循 Windows 高对比度。默认开启，可用于 VCL（Delphi 7 到 13）、Windows 上的 FireMonkey、WinForms、WPF 和 Avalonia。 | 帮助 | |
| 询问仪表板 | TsgcVCLDashboardAI 和 TsgcFMXDashboardAI（.NET 中为 TsgcWinFormsDashboardAI、TsgcWpfDashboardAI 和 TsgcAvaloniaDashboardAI）接收来自 AI 查询栏的问题，并将其发送给能够回答的磁贴。带有 TsgcGridAI 或 TsgcPivotGridAI 的网格或透视表磁贴给出回答并被带入视图，KPI 卡片或仪表磁贴根据自己的标题和数值在本地回答，图表或地图磁贴则会被显示并获得焦点。在注册版中，问题还可以设置交叉筛选，例如 Region = West（LastFilter、ApplyFilters）。提供程序只能看到磁贴标题和类型以及列名，因此 KPI、仪表和列的值绝不会离开应用程序。未设置提供程序时，由本地规则路由器选择磁贴。 | ~面向所有磁贴的路由；带筛选的回答属于注册版。 | 帮助 |
.NET 仪表板是类名相同的 C# 移植版本，适用于 WinForms、WPF 和 Avalonia，附带无界面包和实时数据桥接。
| 包 | 版本 | 内容 |
|---|---|---|
esegece.sgcDashboard.Community | 社区版（免费） | 核心库 |
esegece.sgcDashboard.WinForms.Community | 社区版（免费） | Windows Forms 控件 |
esegece.sgcDashboard.Wpf.Community | 社区版（免费） | WPF 控件 |
esegece.sgcDashboard.Avalonia.Community | 社区版（免费） | Avalonia 控件 |
esegece.sgcDashboard.Rendering.Community | 社区版（免费） | 无头渲染 |
esegece.sgcDashboard.Charts.Avalonia.Community | 社区版（免费） | sgcCharts 磁贴，适用于 Avalonia |
esegece.sgcDashboard.Charts.WinForms.Community | 社区版（免费） | sgcCharts 磁贴，适用于 WinForms |
esegece.sgcDashboard.Charts.Wpf.Community | 社区版（免费） | sgcCharts 磁贴，适用于 WPF |
esegece.sgcDashboard.Gauges.Avalonia.Community | 社区版（免费） | sgcGauges 磁贴，适用于 Avalonia |
esegece.sgcDashboard.Gauges.WinForms.Community | 社区版（免费） | sgcGauges 磁贴，适用于 WinForms |
esegece.sgcDashboard.Gauges.Wpf.Community | 社区版（免费） | sgcGauges 磁贴，适用于 WPF |
esegece.sgcDashboard.Grid.Avalonia.Community | 社区版（免费） | sgcGrid 磁贴，适用于 Avalonia |
esegece.sgcDashboard.Grid.WinForms.Community | 社区版（免费） | sgcGrid 磁贴，适用于 WinForms |
esegece.sgcDashboard.Grid.Wpf.Community | 社区版（免费） | sgcGrid 磁贴，适用于 WPF |
esegece.sgcDashboard.Maps.WinForms.Community | 社区版（免费） | sgcMaps 磁贴，适用于 WinForms |
esegece.sgcDashboard.PivotGrid.Avalonia.Community | 社区版（免费） | sgcPivotGrid 磁贴，适用于 Avalonia |
esegece.sgcDashboard.PivotGrid.WinForms.Community | 社区版（免费） | sgcPivotGrid 磁贴，适用于 WinForms |
esegece.sgcDashboard.PivotGrid.Wpf.Community | 社区版（免费） | sgcPivotGrid 磁贴，适用于 WPF |
esegece.sgcDashboard | 注册版 | 核心库 |
esegece.sgcDashboard.WinForms | 注册版 | Windows Forms 控件 |
esegece.sgcDashboard.Wpf | 注册版 | WPF 控件 |
esegece.sgcDashboard.Avalonia | 注册版 | Avalonia 控件 |
esegece.sgcDashboard.Rendering | 注册版 | 无界面渲染 |
esegece.sgcDashboard.sgcWebSockets | 仅限注册版 | sgcWebSockets 桥接 |
esegece.sgcDashboard.Charts.Avalonia | 注册版 | sgcCharts 磁贴，适用于 Avalonia |
esegece.sgcDashboard.Charts.WinForms | 注册版 | sgcCharts 磁贴，适用于 WinForms |
esegece.sgcDashboard.Charts.Wpf | 注册版 | sgcCharts 磁贴，适用于 WPF |
esegece.sgcDashboard.Gauges.Avalonia | 注册版 | sgcGauges 磁贴，适用于 Avalonia |
esegece.sgcDashboard.Gauges.WinForms | 注册版 | sgcGauges 磁贴，适用于 WinForms |
esegece.sgcDashboard.Gauges.Wpf | 注册版 | sgcGauges 磁贴，适用于 WPF |
esegece.sgcDashboard.Grid.Avalonia | 注册版 | sgcGrid 磁贴，适用于 Avalonia |
esegece.sgcDashboard.Grid.WinForms | 注册版 | sgcGrid 磁贴，适用于 WinForms |
esegece.sgcDashboard.Grid.Wpf | 注册版 | sgcGrid 磁贴，适用于 WPF |
esegece.sgcDashboard.Maps.WinForms | 注册版 | sgcMaps 磁贴，适用于 WinForms |
esegece.sgcDashboard.PivotGrid.Avalonia | 注册版 | sgcPivotGrid 磁贴，适用于 Avalonia |
esegece.sgcDashboard.PivotGrid.WinForms | 注册版 | sgcPivotGrid 磁贴，适用于 WinForms |
esegece.sgcDashboard.PivotGrid.Wpf | 注册版 | sgcPivotGrid 磁贴，适用于 WPF |
sgcDashboard 的每项功能都记录在 sgcUI 帮助中，每种开发环境各有一个版本。