sgcGauges 功能矩阵
按任务分类的 sgcGauges 全部功能，每项功能都链接到对应的帮助主题。每种仪表都有一个无界面模型、一个 VCL 控件、一个 FireMonkey 控件和三个 .NET 控件。
按任务分类的 sgcGauges 全部功能，每项功能都链接到对应的帮助主题。每种仪表都有一个无界面模型、一个 VCL 控件、一个 FireMonkey 控件和三个 .NET 控件。
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 径向 | 带刻度、量程和指针的表盘仪表。 | 帮助 | |
| 线性 | 一个仪表集柱状、温度计和子弹图于一身：LinearStyle 为 glsBar、glsThermometer、glsBullet，另有 Target。 | 帮助 | |
| 数字 | 7 段显示。带残影段和倾斜的 14 段与点阵显示仅限注册版。 | 帮助 | |
| LED 和 LED 条 | 闪烁的 LED 和带峰值保持的 LED 条。 | 帮助 | |
| 进度环 | 环形进度指示器。 | 帮助 | |
| 水箱和容器 | TsgcVCLTankGauge（FireMonkey 上为 TsgcFMXTankGauge，WinForms、WPF 和 Avalonia 中名称相同）在过程画面中显示容器的液位。Shape 可绘制立式圆柱、卧式胶囊、锥底或球形。LimitHH、LimitH、LimitL 和 LimitLL 在容器上标出 ISA 限值，LimitHysteresis 会保持限值状态，直到液位明显离开，LimitState 报告该状态，同时水箱绘制 HH、H、L 或 LL 徽标，因此状态从不只依赖颜色。 | 帮助 | |
| 过程符号 | TsgcVCLSymbolGauge（FireMonkey 上为 TsgcFMXSymbolGauge，WinForms、WPF 和 Avalonia 中名称相同）按过程状态绘制阀门、泵、电机、风机、换热器或传感器（Kind）：关、开、故障、打开、关闭或过渡（State）。运行中的泵或风机会旋转，故障会带标记闪烁，过渡中的阀门带虚线轮廓。Rotation 用于旋转符号，设备位号绘制在其下方。 | 帮助 | |
| VU 表 | 音频电平表。 | 注册版 | 帮助 |
| 时钟和罗盘 | 模拟时钟和罗盘仪表。 | 注册版 | 帮助 |
| 报警指示面板 | 报警磁贴会持续闪烁直到被确认（Acknowledge、OnTileClick）。 | 注册版 | 帮助 |
| 输入仪表 | TsgcVCLKnobGauge、TsgcVCLSliderGauge、TsgcVCLToggleSwitchGauge 和 TsgcVCLPushButtonGauge（FireMonkey 中为 TsgcFMX，WinForms、WPF 和 Avalonia 中名称相同）让用户设置数值：用鼠标、触摸、滚轮或键盘旋转旋钮、拖动滑块、拨动开关或按下按钮。Step 使数值按步进对齐，ReadOnly 将其锁定，按钮可以是瞬时型或自锁型（Mode），OnUserChange 只在用户所做的更改时触发。它们在从右到左的布局中镜像显示，屏幕阅读器会把它们识别为滑块、拨动开关和按钮。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 动画 | 指针会以动画方式移到每个新值，默认 300 毫秒，提供五种缓动曲线：geLinear、geQuadOut、geCubicOut、geCubicInOut、geBackOut。 | 帮助 | |
| 主题 | 一个属性即可切换浅色和深色主题：Theme := utDark。 | 帮助 | |
| 皮肤 | Skin 按名称选择已注册的皮肤：Classic（默认外观）、Modern、Industrial、ISA101 和 Dark。SkinData 为单个仪表设置自己的颜色：表面、边框、轨道、刻度、标签、指针、LED、报警级别和输入仪表的各个部件，以及表面、边框和指针的样式、标签和数值的字重。sgcGaugesRegisterSkin 添加您自己的皮肤，sgcGaugesSetDefaultSkin 把某个皮肤应用到每个仪表。仪表上设置的颜色优先于皮肤，皮肤优先于主题，而 Windows 高对比度主题始终优先。皮肤可以保存为 JSON 并从 JSON 加载。 | 帮助 | |
| 无界面渲染 | 每个控件和模型上的 SaveToPNG 和 SaveToSVG，在 Linux64 以及 .NET ConsoleRender 演示中同样可用。 | 帮助 | |
| 从右到左（阿拉伯语和希伯来语） | 标题和单位文本的位置遵循方向。表盘、时钟、指南针、VU 表以及线性和环形进度保持原有方向。 | 帮助 | |
| 打印和打印预览 | 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）。 | 注册版 | 帮助 |
| 无障碍 | 每种仪表都向 UI Automation 公开其标题、值和量程，阈值作为通知发出。仪表默认不是 Tab 停靠点，因为它们只显示值，通过 TabStop 可将其加入 Tab 顺序。遵循 Windows 高对比度。默认开启，可用于 VCL（Delphi 7 到 13）、Windows 上的 FireMonkey、WinForms、WPF 和 Avalonia。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 数据集绑定 | TsgcGaugeDataLink 在任意 VCL 或 FireMonkey 仪表上显示数据集字段的值（DataSource、DataField、Gauge），并跟随当前记录、其编辑和提交。在 .NET 中，它绑定 DataTable 或 DataView 的列，TsgcWinFormsGaugeDataLink 则跟随 WinForms 窗体的 CurrencyManager。用户对输入仪表所做的更改会写回字段，并触发 OnBeforeWriteBack、OnWriteBack 和 OnWriteBackError；被拒绝或失败的写入会让仪表恢复为字段的值。在 WPF 和 Avalonia 中，输入仪表的 Value 和 Checked 属性可与视图模型双向绑定。 | ~读取字段包含在每个版本中。写回为注册版功能。 | 帮助 |
| MQTT、WebSocket 和 SSE 绑定 | sgcGaugesWS 通过 ValuePath、FilterPath 和 FilterValue，将 MQTT 主题（支持 + 和 # 过滤）以及 WebSocket 和 SSE 消息中的 JSON 字段绑定到仪表指针。需要 sgcWebSockets。 | 注册版 | 帮助 |
| 水箱和过程符号数据源 | sgcGaugesWS 的 MQTT、WebSocket 和 SSE 绑定可驱动水箱的液位和过程符号的状态。符号也接受状态名称，例如 "open" 或 "on"，ValueMap 则把工厂发送的代码，例如 PLC 位或 RUNNING 这样的状态文本，转换为符号状态。需要 sgcWebSockets。 | 注册版 | 帮助 |
.NET 仪表是类名相同的 C# 移植版本，适用于 WinForms、WPF 和 Avalonia，实时数据桥接为单独的包。
| 包 | 版本 | 内容 |
|---|---|---|
esegece.sgcGauges.Community | 社区版（免费） | 核心库 |
esegece.sgcGauges.WinForms.Community | 社区版（免费） | Windows Forms 控件 |
esegece.sgcGauges.Wpf.Community | 社区版（免费） | WPF 控件 |
esegece.sgcGauges.Avalonia.Community | 社区版（免费） | Avalonia 控件 |
esegece.sgcGauges.Rendering.Community | 社区版（免费） | 无头渲染 |
esegece.sgcGauges | 注册版 | 核心库 |
esegece.sgcGauges.WinForms | 注册版 | Windows Forms 控件 |
esegece.sgcGauges.Wpf | 注册版 | WPF 控件 |
esegece.sgcGauges.Avalonia | 注册版 | Avalonia 控件 |
esegece.sgcGauges.Rendering | 注册版 | 无界面渲染 |
esegece.sgcGauges.sgcWebSockets | 仅限注册版 | sgcWebSockets 桥接 |
sgcGauges 的每项功能都记录在 sgcUI 帮助中，每种开发环境各有一个版本。