3.7 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.数据类型：选择[UINT16、INT16、UINT32、INT32、UINT64、INT64、FLOAT、DOUBLE]。

5.整数位数：选择[自动、1~16]。设置数值整数部分的位数。

5.1 前补零：选择[无、补0]。整数位数不足时，前面补0。

6.小数位数：选择[0~10]。整数类型用于表达定点小数，浮点数用于保留小数位数。

如：整数类型(UINT/INT)，原值（串口指令传输的值）2156 设置2位小数，显示为21.56。

​ 浮点类型，原值（串口指令传输的值）24.435 设置1位小数，显示为24.4。

6.1 后补零：选择[无、补0]。小数位数不足时，后面补0。

7.特殊转换：选择[禁用、启用]。表示是否对数值进行线性变换。

7.1缩放：转换系数，即y=kx+b的k值。

7.2偏移：转换偏移量，即y=kx+b的b值。

8.附加单位：数值末尾添加单位显示，最多4个字节。

8.1无空格：选择[禁用、启用]。启用后，数值和单位之前无空格。

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

10.范围限制：选择[无、固定范围、可变范围]。

• 固定范围

10.1下限值：可输入数值的最小值。

10.2上限值：可输入数值的最大值。

• 可变范围：

10.1 下限地址：最小值从该地址获取。

10.2 上限地址：最大值从该地址获取。

10.3 警示色：选择[禁用、启用]。设置数值超出上下限值时的颜色。

10.3.1 颜色用于：选择[文字、背景]。警示色对谁有效。

10.3.2 下限颜色：超下限值时的颜色。

10.3.3 下限闪烁：选择[禁用、启用]。超下限值时文字是否闪烁。

10.3.4 上限颜色：超上限值时的颜色。

10.3.5 上限闪烁：选择[禁用、启用]。超上限值时文字是否闪烁。

10.4 越界数值显示：选择[正常显示、####、****、----、空白显示]。

10.5 键盘输入越界时：选择[禁止设置、设为边界值、取消设置]。表示在弹出键盘中，输入了超限值该如何处理。

二、外观设置

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

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

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

4.文字颜色：文字颜色。

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

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

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

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

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

7.控制地址：控制文字属性的地址。如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如图，

1.2 三个【数值】输入控件属性依次如下

1.3 运行

修改三个【数值】输入控件的值，观察第1个【数值】控件的变化

演示【可变上下限值】

2.1如下图

2.2 三个【数值】输入控件属性依次如下

2.3 运行

修改三个【数值】输入控件的值，使其超过上限或下限，观察第1个【数值】控件的颜色变化

演示【修改字体、字体大小、前景色、背景色、小数位数】

3.1 下图【数值】控件属性

3.2 字体大小【数值】控件属性

控制地址0~7位表示字体大小

3.3 字体编号【数值】控件属性

控制地址0~7位表示字体编号(示例中默认有2个字体，分别为0和1)

3.4 前景色BGR下面的四个输入框分别绑定地址，颜色为RGB565格式存储

LW2003.1~4：控制地址+1的0~4位表示前景色中的蓝色，范围0~31

LW2003.5~10：控制地址+1的5~10位表示前景色中的绿色，范围0~63

LW2003.11~15：控制地址+1的11~15位表示前景色中的红色，范围0~31

LW2003：用来查看最终的RGB565颜色值

3.5 背景色BGR下面的四个输入框分别绑定地址，颜色为RGB565格式存储

LW2004.1~4：控制地址+2的0~4位表示前景色中的蓝色，范围0~31

LW2004.5~10：控制地址+2的5~10位表示前景色中的绿色，范围0~63

LW2004.11~15：控制地址+2的11~15位表示前景色中的红色，范围0~31

3.6 运行

修改字体、颜色，观察第一个【数值】控件中变化

演示【特殊转换】属性，即值的线性变换

4.1 左【数值】控件属性：启用特殊转换

4.2 右【数值】控件属性：禁用特殊转换

4.3 运行

在【数值】控件中输入，观察另一个【数值】控件的值变化

演示【UINT64数据类型】

注意：64位需使用4个寄存器

运行：略

演示【INT64数据类型】

略

演示【FLOAT数据类型及小数补零】

FLOAT为32位，需用2个寄存器，属性设置不同之处如图，其余说明略。

演示【DOUBLE数据类型及小数补零】

DOUBLE为64位，需占用4个寄存器，属性设置不同之处如图，其余说明略。

演示【附加单位】后缀

属性设置不同之处如图，其余说明略。

演示【密码显示】

属性设置不同之处如图，其余说明略。