3.8 文本输入

文本输入控件显示地址中的字符串，支持弹出字母键盘、密码显示和长度限制。

核心功能

• 字符串读写：显示地址中的文本，或通过字母键盘输入。
• 编码适配：支持 GB CODE、UTF8、UNICODE 及高低字节互换。
• 输入约束：设置最大长度，并可启用密码显示。

本节案例：输入与同步显示；密码、长度与编码。

下载示例工程 · 下载配套素材

打开第 8 页。工程为 1024×600，地址使用 LW（十六进制）。

1. 属性介绍

共用设置：位置尺寸 · 文字与图片 · 执行与声音 · 动态特效 · 安全设置。本节说明控件专有属性，图中序号对应下表。

1.1 功能设置

序号	属性	作用
1～7	输入与键盘	共用设置，见 输入与键盘。
8	读取地址	读取控件需要显示的数据；按工程协议选择地址。
9	写入地址	选择与读取地址相同或不同；不同时填写独立地址。
10	地址	读写分离时，填写独立的写入地址。
11	最大长度	预留字符串容量，应包含结束符；中文字符的字节数随编码变化。
12	编码	选择 GB CODE、UTF8 或 UNICODE，与写入数据的编码保持一致。
13	密码显示	用掩码隐藏实际内容。
14	高低字节互换	交换每个字内的高、低字节，用于匹配设备字节顺序。
15	不拆单词	自动换行时尽量保持单词完整。
16	单行模式	只显示一行，不自动换行。

1.2 外观设置

序号	属性	作用
1～6、8	文字与图片	共用设置，见 文字与图片。
7	速度	设置文字移动速度；数值越大，移动越快。
9	显示背景	选择无背景、颜色背景或图片背景。
10	背景颜色	设置背景填充颜色。
11	输入背景颜色	启用后，为正在输入的区域指定背景颜色。
12	输入颜色	正在输入时的背景颜色。
13	控制地址	运行时控制所用的寄存器起始地址；本例留空。

1.3 图片背景

序号	属性	作用
1～6、8	文字与图片	共用设置，见 文字与图片。
7、9、11～13	同名属性	含义与本节前面的同名属性相同。
10	背景图片	选择背景图片，或启用图片背景后配置对应图片项。

2. 应用案例

2.1 输入与同步显示

2.1.1 工程配置

添加两个文本输入控件，读取同一地址，仅左侧启用输入。

控件 / 项目	地址 / 对象	设置
设备名称	LW1700	UTF8；最大长度 32；启用输入
同地址显示	LW1700	UTF8；最大长度 32；关闭输入

名称输入：UTF8、最大长度 32：

同址显示：关闭启用输入：

2.1.2 运行预览

点击名称，使用字母键盘输入 sunny 并确认，两处文字同时更新。

2.2 密码、长度与编码

2.2.1 工程配置

添加密码文本和短文本。点击“编码示例”可对照 GB CODE、UTF8 和字节互换的显示。

控件 / 项目	地址 / 对象	设置
密码	LW1720	UTF8；最大长度 32；密码显示
短文本	LW1740	UTF8；最大长度 12
GB CODE / UTF8	LW17A0 / LW17C0	写入匹配编码的“清新温室”
字节互换	LW17E0	启用高低字节互换

密码文本配置：

短文本：最大长度 12：

2.2.2 运行预览

密码确认后显示星号；短文本保存 green。中文出现乱码时，先检查编码和字节顺序。

2.3 编码对照

第 28 页的两个中文案例分别使用 GB CODE 和 UTF8；字节互换案例读取每字低字节在前的数据。

GB CODE 中文编码：

UTF8 中文编码：

高低字节互换：