带错误值的 IO 字段 | Custom Web Control | WinCC Unified & V8

Custom Web Control

关于带错误值的 IO 字段

带错误值的 IO 字段是一款适用于 WinCC Unified (TIA Portal) 和 WinCC V8 的 Custom Web Control。它在 IO 字段中显示过程值；当该值与定义的错误值匹配时，将其替换为红色叉号和消息。操作员可以立即看出测量值无效或不可用，而不会误读一个具有误导性的数字。

主要功能

• 错误检测：在 errorTolerance 范围内将 processValue 与 errorValue 进行比较，字段会自动切换至错误状态。
• 清晰的错误指示：红色叉号符号及 errorText 消息会替换数值，因此状态绝不只依赖于颜色。
• 操作员输入：在 InputOutput 模式下，确认的输入值会与 minValue 和 maxValue 进行检查，然后写回 processValue。
• 一致的更新：tag 更新和 setValue 方法采用相同的错误检测机制。

自定义

使用 unit 和 decimals 设置值格式，并使用 alignment 和 verticalAlignment 调整值的位置。字体排印由 fontFamily、fontSize、fontStyle、fontUnderline 和 fontStrikethrough 控制，其中 fontSize 为 0 时，值会随控件高度缩放。颜色通过 backgroundColor、borderColor 和 textColor 设置，而 showBackground 和 showBorder 控制容器和边框。fieldLabel 和 errorLabel 属性提供无障碍标签，rangeTooltipText 设置输入范围提示。

使用场景

适用于可能由传感器报告故障值的储罐液位和流量显示、带已知故障代码的模拟输入、控制室总览，以及绝不能将无效数据误认为真实读数的操作员面板。对于只读过程值，请使用 Output 模式。

兼容性

适用于 WinCC Unified (TIA Portal) 和 WinCC V8。它仅使用离线系统字体和内嵌图形，因此不需要外部服务。

TIA Portal 提醒：对于控件必须写入且与 processValue 关联的任何 tag，请在 TIA Portal 中取消选中 Read only 选项。否则，控件可以读取 HMI tag，但无法将操作员输入写回。

AI 生成：此 custom web control 使用 AI 自动生成。投入生产环境前，请对其进行全面测试和验证。

⚠️ AI 生成：此 custom web control 使用 AI 技术自动生成。它可能包含错误或意外行为。用户负责在生产环境中使用前进行测试和验证。

## 当前版本：v1 (2026-10-26)