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