3.7 TFT数值输入控件

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

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

数值输入

1. 【数值】输入用于数字的输入，注意与【文本】输入的区别

一、功能设置

1.启用输入：是否启用文字键盘输入功能。

• 键盘类型：选择弹出键盘 。

• 键盘画面：可选择系统内置的键盘画面和用户自定义键盘画面。

• 键盘位置：设置弹出键盘所在的位置，目前有“元件上侧”、“元件下侧”、“元件左侧”、“元件右侧”、“屏幕上边”、“屏幕下边”、“屏幕左边”、“屏幕右边”、“屏幕居中”、“自定义”。其中“自定义”可以指定键盘弹出的具体坐标位置。

• 键盘初始值：键盘是否有初始值。

  2.读取地址：控件读取绑定的寄存器地址。

  3.写入地址：控件写入绑定的寄存器地址，可设置与读取地址不同。

  4.数据类型：支持“UINT16”、“INT16”、“UINT32”、“INT32”、“UINT64”、“INT64”、“FLOAT”、“DOUBLE”的数据格式。

  5.整数位数：设置数值整数部分的位数，可设置前补零。

  6.小数位数：整数类型用于表达定点小数，浮点数用于保留小数位数。

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

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

  7.特殊转换：是否对数值进行线性变换。

• 缩放：数值按比例进行缩放转换。

• 偏移：数值偏移转换。

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

• 无空格：勾选后，单位和值更加紧凑。

  9.密码显示：是否启用密码显示。启用后每个数字会被"*"取代显示

  10.范围限制：

• 无：无范围限制

• 固定范围

• 下限值：变量数值的最小值

• 上限值：变量数值的最大值

• 可变范围：

  • 下限地址：变量数值的最小值地址；

  • 上限地址：变量数值的最大值地址；

    11.警示色：设置数值上下限值时的颜色。

• 颜色用于：设置警示色用于文字或者文字背景。

• 下限颜色：下限值时的颜色。

• 下限闪烁：设置下限值时是否闪烁。

• 上限颜色：上限值时的颜色。

• 上限闪烁：设置上限值时是否闪烁。

  12.越界数值显示：正常显示、“####”、“*”、“----”、空白显示

  13.键盘输入越界时：设置键盘输入值超出范围时的效果，禁止设置、设为边界值、取消设置

二、外观设置

1.字体名称：选择显示文字的字体

2.字体大小：显示字体的大小

3.对齐：“左”、“右”、“居中”

4.文字颜色：显示文字的颜色

5.显示背景：

(1)无：无显示背景;

(2)背景颜色：控件背景以颜色的形式显示;

(3)背景图片：控件背景以图片的形式显示;

6.输入背景色：输入背景色

7.控制地址：动态设置字体(编号|大小)、前景色(RGB)、背景色(RGB)，以运行时把文字变红、字体变大

PLC 往 LW1000~LW1003 写入：

LW[1000] = 0x0118 // 字库1, 24号字体

LW[1001] = 0xFF00 // 0xF8, 0x00 （565红色 字体）

LW[1002] = 0x001F // 0x00, 0x1F （565蓝色 背景）

三、应用示例

如图放置【文字】和【数值】控件

演示【位操作】

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个寄存器，属性设置不同之处如图，其余说明略。

演示【附加单位】后缀

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

演示【密码显示】

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