文本控件用于문자串型변수的显示与键盘입력：设备状态提示、매개변수설정、用户注释。支持 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)控件튜토리얼「文本控件」，版权归大彩科技所有。
답글 작성