博图V18中HMI文本框为何无法正常换行？

Question

在博图V18中，HMI文本框（Text Field）无法正常换行是常见问题，主因有三：一是未启用“多行显示”属性（Multi-line = true），默认为单行模式，回车符被忽略；二是文本源为PLC变量（如STRING或WSTRING）时，若变量中未嵌入ASCII换行符（0x0A或0x0D0A），仅靠手动输入回车无效；三是字体高度或控件高度不足，导致即使内容含换行符也被截断或渲染为单行。此外，使用“静态文本”（Static Text）控件时，其不支持运行时动态换行，须改用“文本字段”并绑定变量。解决建议：① 检查控件属性→启用Multi-line；② 确保PLC端写入含LF/CR-LF的字符串（如SCL中用CONCAT+CHAR(10)）；③ 调整控件高度≥两行字体高度，并关闭“自动调整大小”以避免高度重置。该问题本质是博图对文本渲染逻辑与PLC数据格式的严格解耦所致。

Answer 1

```html

一、现象层：HMI文本框“看似换行却无效果”的典型表现

在博图V18的WinCC Advanced或Unified HMI项目中，工程师常遇到以下直观现象：在HMI画面编辑器中双击Text Field输入含回车的多行文本（如“第一行↵第二行”），预览时仍显示为单行；或PLC变量绑定后，字符串内容在监控表中可见换行符（0x0A），但HMI控件内文字挤成一行甚至截断。该现象非UI卡顿或刷新延迟所致，而是底层渲染机制未触发换行解析。

二、配置层：三大核心属性与控件选型的硬性约束

• Multi-line 属性缺失：Text Field默认Multi-line = false，此时所有ASCII控制字符（包括CR/LF）被静默丢弃；启用后才激活行高计算与软换行逻辑。
• Static Text 的固有缺陷：该控件仅支持设计时静态文本，不响应运行时变量更新，更无法解析动态注入的换行符——必须替换为Text Field + 绑定STRING/WSTRING变量。
• 自动调整大小（Auto-size）的隐式干扰：若启用，控件高度将强制收缩至单行字体高度，覆盖手动设置的多行空间，导致即使含LF也无法显示第二行。

三、数据层：PLC端字符串构造的字节级真相

关键矛盾在于：HMI不识别“视觉回车”，只认ASCII码值。STRING/WSTRING变量需显式嵌入0x0A（LF）或0x0D 0x0A（CRLF）。例如SCL代码：

myText := CONCAT('温度:', INT_TO_STRING(temp)) + CHAR(10) + CONCAT('时间:', TOD_TO_STRING(sysTime));

若仅用myText := '温度:25°C\n时间:14:30';（\n为转义字符而非字节），编译后实际未写入0x0A，HMI自然无法换行。

四、渲染层：字体度量与控件几何的物理边界

参数	最小安全值	验证方法
控件高度	≥ 字体高度 × 2 + 行间距（建议+4px）	右键控件→“属性”→“外观”→查看“高度”数值
字体大小	≥ 8pt（过小导致行高计算溢出）	在“字体”设置中确认像素等效值

五、系统层：博图V18架构解耦的本质归因

该问题根植于TIA Portal的分层设计哲学：PLC数据层（字节流）与HMI呈现层（GUI渲染引擎）完全隔离。PLC不理解“换行语义”，HMI不主动解析字符串结构——二者仅通过标准化数据类型（STRING/WSTRING）传递原始字节。换行行为必须由开发者在两端协同实现：PLC注入规范控制码，HMI控件启用对应解析能力，并预留足够渲染空间。这种解耦提升了系统可靠性，但也要求工程师具备跨层调试能力。

六、诊断流程：从HMI到PLC的五步闭环排查

flowchart TD A[观察HMI显示异常] --> B{Text Field是否启用Multi-line?} B -->|否| C[启用并检查高度] B -->|是| D{变量值是否含0x0A?} D -->|否| E[检查PLC字符串构造逻辑] D -->|是| F[验证控件高度与字体匹配度] C --> G[重新测试] E --> G F --> G

七、进阶实践：WSTRING的Unicode换行兼容性要点

当使用WSTRING（宽字符）时，需注意：LF仍为WCHAR#10，但部分旧版SCL函数块（如MOVE_WSTRING）可能截断末尾空字符，导致换行符丢失。推荐使用CONVERT_WSTRING配合显式字节拼接，并在博图“变量表”中启用“十六进制显示”模式直接验证0x000A是否存在。

八、防错设计：模板化控件与PLC函数块复用方案

为避免重复踩坑，建议创建两项可复用资产：
① HMI端：预配置好的“Multi-line Text Field”模板（已设高度=32px、字体=10pt、Auto-size=off）；
② PLC端：封装好的F_StringWithLineFeed函数块，输入多段文本及分隔符（如LF），自动注入CHAR(10)并处理长度边界。

九、版本差异警示：V18相较V16/V17的关键变更

博图V18强化了WSTRING的UTF-16校验逻辑，若PLC写入非法代理对（surrogate pair），HMI可能静默丢弃整段字符串（含换行符）。而V16对此容忍度更高。因此升级项目必须重测所有含换行的WSTRING路径，并启用PLC端字符串长度校验（LEN() > 0）。

十、工程启示：自动化测试用例的设计范式

在CI/CD流水线中，应加入如下HMI换行验证用例：
- 用脚本向仿真PLC写入含0x0A的STRING变量；
- 启动HMI Runtime并截图；
- 调用OpenCV检测图像中文字行数（对比预期2行）；
- 失败时自动标注控件坐标并导出变量快照。此方法将主观“肉眼判断”转化为客观质量门禁。

```