文本控件用于字符串型变量的显示与键盘输入：设备状态提示、参数配置、用户注释。支持 GBK/UTF-8/UNICODE Coding，最大 2KB 存储。
1. 核心特性
- 输入：HMI 内置键盘输入，支持 GBK、UTF-8 Coding
- PLC 通信编码：GBK（中文内码，兼容 GB2312）、UTF-8、UNICODE——须与 PLC 协议定义一致
- 长度限制：最大 2KB(2048 바이트)；GBK 约 1024 个中文（2字节/字），UTF-8 中文约 682 characters（3字节/字）、英文 2048 characters
2. 属性介绍
2.1 功能设置
| 属性 | 说明 |
|---|---|
| 启动输入 | 是否允许键盘输入 |
| 键盘类型/画面/位置/初始值 | 弹出键盘/外接键盘；键盘画面；弹出位置；是否显示初始值 |
| 提示信息 | 关联文字标签，键盘画面控件关联 $SysKBTipInfo 显示 |
| read/写入地址 | 可相同或不同 |
| 最大长度 | 文本输入的最大字节数 |
| Coding | 键盘输入：GBK/UTF-8；显示：GBK/UTF-8/UNICODE |
| 密码显示 | 内容以 * 显示 |
| 高低字节互换 | 字符串高低字节交换（配合特定 PLC 存储顺序） |
2.2 外观设置
- 字体/大小/对齐：左/居中/右
- 不拆分单词：多行显示时不在行末拆断单词（英文/德语等）
- 行间距/字距离：行距是字体大小倍数；字距是像素
- 闪烁/跑马灯：闪烁频率；跑马灯方向（左/右/上/下移动）+ 速度（像素/秒）
- 控制地址：同数值控件——+0 字体(高8字库/低8字号)、+1 前景色 RGB565、+2 背景色 RGB565
3. 应用案例
3.1 UTF-8 编码输入
read LW1001，Coding UTF-8，键盘画面 101_full800*480，提示信息关联标签。输入"你好"，DCBUS 下发的帧是 AA 55 00 0E F2 10 01 04 E4 BD A0 E5 A5 BD 00 00 CC CC——注意 UTF-8 中文每字 3 byte（E4 BD A0 = 你）。
3.2 GBK Coding
read LW1020，Coding GBK。输入"你好"下发 AA 55 00 0C F2 10 20 03 C4 E3 BA C3 00 00 CC CC——GBK 中文每字 2 바이트（C4 E3 = 你）。和 UTF-8 的帧对比，能直观看出编码差异。
3.3 高低字节互换 + 控制地址
read LW1040，Coding GBK，勾选高低字节互换，控制地址 LW8000。输入"AB"下发 ... 42 41 ...（高低互换后 B A 传输）；PLC 发 31 32 33 34 显示为 2143。控制地址 LW8000=0x0132 显示字库1/50号字，LW8001 前景、LW8002 背景。
3.4 UNICODE + 跑马灯
read LW1060，Coding UNICODE，跑马灯左移动速度 10。输入"你好，VisualHMI"，文字从右往左滚动显示。
编码三连坑：①键盘编码和 PLC 侧必须一致，GBK 输进去 UTF-8 读出来就是乱码；②UNICODE 编码下中文字符占 2 바이트但 UTF-8 占 3 byte，寄存器数量要算对；③高低字节互换勾了没——很多国产 PLC 字符串存储是高字节在前，不勾就显示反了。
整理自 广州大彩科技 VisualHMI 开发文档（hmi-doc.gz-dc.com）组态控件教程「文本控件」，版权归大彩科技所有。
Leave a Reply