sgcDiagram 功能矩阵
按任务分类的 sgcDiagram 全部功能，每项功能都链接到对应的帮助主题。保存为 JSON 的图表可在 Delphi、C++ Builder 和 .NET 中打开。
按任务分类的 sgcDiagram 全部功能，每项功能都链接到对应的帮助主题。保存为 JSON 的图表可在 Delphi、C++ Builder 和 .NET 中打开。
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 面板与编辑器 | 用户将形状从 TsgcVCLDiagramPalette 拖到 TsgcVCLDiagramView 上，连接端口并就地编辑文字。 | 帮助 | |
| 14 种形状 | 流程、判断、终止符、数据、文档、容器、图像、SVG 路径等。 | 帮助 | |
| 连接线 | 带标签和箭头的直线、正交和曲线连接线。避障连线仅限注册版。 | ~社区版把正交连接线路由为简单的折角，不会绕开节点。 | 帮助 |
| 端口与吸附 | 连接线吸附到节点的端口上并随节点移动。 | 帮助 | |
| 撤销与剪贴板 | 每个操作都可撤销和重做，可通过 BeginTransaction 和 EndTransaction 将更改分组，支持复制和粘贴。 | 帮助 | |
| 吸附与参考线 | 吸附网格和对齐参考线。 | 帮助 | |
| 图层 | 一个图表中可有多个图层。社区版只有一个图层。 | 注册版 | 帮助 |
| 无障碍 | 节点、连接线、分组和形状面板向 UI Automation 公开，并有为图表生成的替代文本。键盘替代方式可移动、微调和调整节点大小、绘制连接线（Ctrl+K）并从面板添加形状，焦点环始终可见，并遵循 Windows 高对比度。默认开启，可用于 VCL（Delphi 7 到 13）、Windows 上的 FireMonkey、WinForms、WPF 和 Avalonia。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 8 个形状库，278 个模具 | Flowchart、Basic、Org chart、Network、BPMN、UML、P&ID 和 Mind map，由 eSeGeCe 绘制并按需加载。调色板可搜索每个模具的名称和关键字，其 Libraries 属性决定显示哪些库。 | ~Community 包含 Flowchart、Basic、Org chart 和 Network 库（108 个模具）。BPMN、UML、P&ID 和 Mind map 属于注册版。 | 帮助 |
| P&ID 符号（ISA-5.1 风格） | pid 库有 56 个模具，分为六类，用于过程画面：阀门、泵、容器、传热设备、仪表和管道。actuator 属性选择控制阀的执行机构，仪表信号线是连接线的线型。使用 sgcDiagramStencilsEnsureLibrary('pid') 加载它，或把 pid 添加到调色板的 Libraries 中。 | 注册版 | 帮助 |
| JSON 自定义模具 | 在 JSON 文件中描述您自己的形状，包括矢量部件、端口、文本区域和属性，并用 sgcDiagramStencilsLoadFromFile 注册。内置库使用相同的格式。 | 帮助 | |
| 标尺与参考线 | ShowRulers 添加以像素、毫米或英寸为单位的标尺。从标尺拖出参考线，图框会吸附到它，并随图表一起保存。 | 帮助 | |
| 对齐与分布 | 将所选对象左对齐、居中、右对齐、顶端对齐、垂直居中或底端对齐，按中心或按间距分布三个或更多节点，使节点大小相同，更改 z 顺序并翻转。每个命令都是一个撤销步骤。 | 帮助 | |
| 缩略图 | TsgcVCLDiagramMinimap 显示整个图表及可见区域。单击或拖动即可移动视图，滚轮用于缩放。 | 帮助 | |
| 泳道与池（BPMN） | AddPool 和 AddLane 创建带水平或垂直泳道的池，流程的形状是泳道的子项。可以添加、删除、调整大小和折叠泳道。 | 注册版 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 思维导图模式 | 启用 MindMapMode 后，Tab 添加子主题，Enter 添加同级主题，F2 编辑文本。分支可折叠和展开，TsgcDiagramMindMapLayout 使导图始终围绕中心主题排布。 | 注册版 | 帮助 |
| 从 draw.io、Visio、GraphML 和 Mermaid 导入 | ImportFromFile 读取 draw.io（diagrams.net）文件、Visio（.vsdx）文件、GraphML 文件（包括 yEd 图形）和 Mermaid 流程图，并自动识别格式。 | 注册版 | 帮助 |
| 导入 Mermaid 流程图 | sgcDiagramImportMermaid 将 Mermaid 流程图文本转换为节点和连接线：节点形状、带标签的实线、点线和粗线连接、作为容器并具有自身方向的子图，以及 classDef、style 和 linkStyle 的颜色。节点使用分层布局放置，不支持的语句作为警告列出，语法错误会报告其所在行，并保持图表不变。 | 注册版 | 帮助 |
| 实时状态颜色 | TsgcDiagramStatusBinding 按键值为节点和连接线着色，规则涵盖颜色、徽章、闪烁、不透明度和动画虚线。状态是叠加层，因此保存的图表不会改变。 | 注册版 | 帮助 |
| 过程状态和动画管道 | TsgcDiagramStatusBinding 的规则把标签值转换为设备的过程状态（State：关、开、故障、打开、关闭或过渡），以状态颜色、该状态的模具部件和故障标记绘制，并转换为管道的流动（Flow），以沿连接线向前或反向移动的虚线绘制。启用减少动态效果时，虚线保持静止，并由箭头指示方向。 | 注册版 | 帮助 |
| 来自 sgcWebSockets 的实时状态 | TsgcDiagramWSStatusSource 通过 sgcWebSockets 的 WebSocket、MQTT 或 HTTP 客户端为状态绑定提供数据。相同的值也可以用 SetValue 从您自己的代码提供。 | 注册版 | 帮助 |
| 更快的连接线路由 | 避开障碍的路由器将网格保存在 Document.RouterCache 中，只重新搜索发生变化的路径，因此移动节点时大型图表依然流畅。 | ~Community 将正交连接线路由为不避开节点的简单折线。 | 帮助 |
| 屏幕阅读器支持 | 缩略图、对齐与分布命令、泳道、思维导图和模具节点都会向屏幕阅读器播报，例如“已添加 1 个主题”。 | ~Community 在其包含的功能上提供此支持。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 分层布局 | 一次调用即可排列整个图表，从左到右或从上到下，且只占一个撤销步骤（TsgcDiagramLayeredLayout）。 | 注册版 | 帮助 |
| 树形布局 | TsgcDiagramTreeLayout 适用于组织结构图和层级结构。 | 注册版 | 帮助 |
| 数据绑定 | TsgcDiagramDataBinding 可根据数据集生成图表，例如由表格生成组织结构图。 | 注册版 | 帮助 |
| 实时双向绑定 | 绑定会在数据集运行时跟随它：新增、修改和删除的记录会按 Id 更新各自的节点，节点保持原来的位置。连线来自第二个数据集（带起点和终点字段的 LinkDataSource）或父级字段，XField、YField、WidthField 和 HeightField 保存位置和大小。使用 WriteBack 时，用户添加、移动、编辑或删除的节点和连线会写回数据集，并触发 OnBeforeWriteBack、OnWriteBack 和 OnWriteBackError；被拒绝或失败的写入会让图表从数据重新加载。Throttle 会把快速变化合并为一次更新。在 .NET 中，WinForms、WPF 和 Avalonia 视图通过各自的数据源以及 NodeXMember、NodeYMember、NodeWidthMember、NodeHeightMember 和 LinkKeyMember 属性实现同样的功能。 | 注册版 | 帮助 |
| NodesSource 与 LinksSource (.NET) | TsgcWpfDiagramView 和 TsgcAvaloniaDiagramView 从集合构建关系图：NodesSource 为每个项目生成一个节点，NodeParentMember 为组织结构图生成指向其父节点的连接线，LinksSource 为关系图的每个项目生成一条连接线。TsgcWinFormsDiagramView 绑定 NodesDataSource 和 LinksDataSource。绑定是单向的：数据变化时会重建关系图。 | 注册版 | 帮助 |
| 设计器与示例关系图 (.NET) | WinForms 视图可在 .NET Framework 以及 .NET 8 或更高版本的 Visual Studio 设计器中打开，没有节点的视图会在设计器以及 WPF 和 Avalonia 预览器中显示一个小型示例流程。在注册版中，智能标记还会显示 Nodes Data Source、Node Key Member、Node Parent Member 和 Links Data Source。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| JSON 文件 | SaveToFile 和 LoadFromFile，同一个文件可在 Delphi、C++ Builder 和 .NET 中打开。 | 帮助 | |
| PNG 和 SVG 导出 | TsgcDiagramRenderer 和视图可保存 PNG 与 SVG，也可在没有窗口的服务器或控制台上使用，包括 Linux64。 | 帮助 | |
| 主题与样式 | 与其他 sgcUI 产品共享的浅色和深色主题、每个节点的样式，以及通过 OnDrawNode 实现的自定义绘制。 | 帮助 | |
| 查看器模式 | ReadOnly 可在不允许编辑的情况下显示图表。 | 帮助 | |
| 从右到左（阿拉伯语和希伯来语） | 调色板、标尺、缩略图和工具栏已镜像；画布保持您的图形的几何形状，图形文本按其自身的方向阅读。dglRightToLeft 会让分层布局和树形布局（注册版）从右侧开始阅读。 | 帮助 | |
| 打印和打印预览 | Print 和 ShowPrintPreview 可以打印整个图示，范围与 PNG 和 SVG 导出相同，不包含选择、手柄和参考线。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，附带无界面渲染包。
| 包 | 版本 | 内容 |
|---|---|---|
esegece.sgcDiagram.Community | 社区版（免费） | 核心库 |
esegece.sgcDiagram.WinForms.Community | 社区版（免费） | Windows Forms 控件 |
esegece.sgcDiagram.Wpf.Community | 社区版（免费） | WPF 控件 |
esegece.sgcDiagram.Avalonia.Community | 社区版（免费） | Avalonia 控件 |
esegece.sgcDiagram.Rendering.Community | 社区版（免费） | 无头渲染 |
esegece.sgcDiagram | 注册版 | 核心库 |
esegece.sgcDiagram.WinForms | 注册版 | Windows Forms 控件 |
esegece.sgcDiagram.Wpf | 注册版 | WPF 控件 |
esegece.sgcDiagram.Avalonia | 注册版 | Avalonia 控件 |
esegece.sgcDiagram.Rendering | 注册版 | 无界面渲染 |
esegece.sgcDiagram.sgcWebSockets | 仅限注册版 | sgcWebSockets 桥接 |
sgcDiagram 的每项功能都记录在 sgcUI 帮助中，每种开发环境各有一个版本。