3.8 TFT【文本】输入控件

版本	内 容 摘 要	日期
V1.0	首次发布	2026/6/14

**【例程下载】**[ApusTFT - 文本输入控件(点击下载)]

文本输入

【文本】输入控件可用于输入各种字符和字符串变量的显示。

一、功能设置

1. 启用输入：选择[禁用、启用]。

1.1 键盘类型：选择[弹出键盘、外接键盘]。暂不支持外接键盘。

1.2 键盘画面：选择键盘画面。可通过[工程]-[键盘]增减键盘画面。

1.3 键盘位置：选择[控件件上侧、控件下侧、控件左侧、控件右侧、屏幕上侧、屏幕下侧、屏幕左侧、屏幕右侧、屏幕居中、自定义]。

1.3.1 X坐标：自定义键盘位置的X坐标。

1.3.2 Y坐标：自定义键盘位置的Y坐标。

1.4 键盘初始值：选择[无、有]。有，则在弹出键盘中显示控件当前值。

2.读取地址：控件将读取该地址的值。

3.写入地址：选择[与读取相同、不同]。

3.1 地址：控件将值写入该地址。

4. 最大长度：可输入的字符串最大字节数。注意UTF8编码下1个汉字为3个字节。

5. 编码：选择[GB CODE、 UTF8、UNICODE]。1个汉字：GB CODE为2字节，UTF8一般为3字节，UNICODE一般为2字节。

6. 密码显示：选择[否、是]。启用后每个数字会被"*"取代显示。

7. 高低位互换：选择[否、是]。是，则寄存器中的高8位与低8位互换。

二、外观设置

1.字体名称：字体名称，通过[工程]-[字库]添加或删除。

2.字体尺寸：字体尺寸，范围8~500。

3.对齐方式：选择[左、中心、右]。

4.字间距：相邻字符之间距离(像素单位)，范围0~255。

5.闪烁：选择[无、0.5秒、1秒]。表示文字是否闪烁频率。

6.跑马灯：选择[无、左移动、有移动、上移动、下移动]。

6.1速度：每秒移动的像素，范围1~10000。

7.文字颜色：文字颜色。

8.显示背景：选择[无、颜色、图片]。无表示透明。

8.1背景颜色：控件背景以颜色的形式显示。

8.2背景图片：控件背景以图片的形式显示。

9.输入背景颜色：选择[禁用、启用]。

9.1输入颜色：点击输入弹出键盘时，该控件的背景颜色。

10.控制地址：控制文字属性的地址。如LW1000，则：

• LW1000.0~7位为字体大小；LW1000.8~15位为字体编号，
• LW1001.0~4|5~10|11~15分别为RGB565文字颜色的蓝|绿|红色部分
• LW1002.0~4|5~10|11~15分别为RGB565背景颜色的蓝|绿|红色部分

三、应用示例

如图放置【文字】和【文本】控件

演示【文本】控件的不同编码及高低字节互换

1. 四个【文本】控件属性依次为：

   

   

   

   

1.2 运行

在不同【文本】中输入相同的中文，查看模拟器的控制台输出编码情况