9. 数值文本控件

用途:以数值形式显示文本,支持数值、小数、货币、十六进制等。显示内容可以通过键盘修改、上位机编辑脚本修改或单片机发送指令修改。

说明:数值范围: -2147483648至2147483647 INT32_T类型

9.1. 属性

数值文本属性

基础属性 : 参考控件概念- 基础属性

坐标属性 : 参考控件概念- 坐标属性

背景属性 : 参考控件概念- 背景属性

加载属性 : 参考控件概念- 加载属性

数值文本属性 :

数值文本控件和按钮控件的文本属性差异如下图

数值文本控件文本属性对比

相同属性:

参考控件概念- 文本属性

不同属性:

  • 自动换行(wrap):自动换行,0-否 1-是(读写)

  • 水平间距(row):字符水平间距,单位像素,范围0-65535(读写)

  • 垂直间距(col):字符垂直间距,单位像素,范围0-65535(读写)

注意:
  1. 数值文本控件相比按钮控件没有文本值属性,它是将特有属性中值(val)以数值形式显示出来。

特有属性 :

数值文本特有属性

  • 值(val):整数数值,范围: -2147483648至2147483647 INT32_T类型 (读写)

    注意: 不支持输入小数,否则上位机弹出提示窗口,如下图:

数值文本输入小数报错

  • 显示格式(fmt):显示格式:0-数值 1-货币 2-十六进制 3-带0x前缀十六进制(读写)

  • 显示长度(len):显示长度:范围0-11,0为自动(读写)

  • 整数位数(il):整数位数,范围:0-11,0表示自动,仅小数位数为0有效(读写)

  • 小数位数(fl):小数位数,范围:0-8,0表示无小数(读写)

  • 输入键盘(kb):键盘页面id,范围0-255,255表示无(只读)

警告

  1. 数值文本控件显示原理:使用值(val)根据显示格式显示出来。

  2. 小数位数不为0,脚本获取到val并不是小数,始终是整数。如:val=1024; fl=2;脚本获取val,不是10.24而是1024。

警告

输入键盘(kb):文本类控件使用键盘,一定要先创建键盘页面,否则输入键盘属性无法配置。


9.2. 事件

弹起事件: 控件按下且弹起后执行

按下事件: 控件按下后执行

键盘输入结束事件: 文本类控件使用键盘输入在关闭时执行


9.3. 功能演示

点击下载演示工程

数值文本功能演示

小技巧

把工程配置的启动页面(pid)改为当前页面ID可以立即显示此页面。


9.3.1. 键盘输入

键盘输入

  • 功能:点击文本弹出键盘页面,使用键盘输入。

  • 实现原理:首先,在上位机控件栏点击系统键盘创建键盘页面,然后在文本控件特有属性->输入键盘属性下拉选择键盘页面。如下图:

特有属性

详细步骤请参考:键盘输入


9.3.2. 显示小数

显示小数

  • 功能:将数值以小数形式显示出来。

  • 实现原理:在 弹起事件 中编写

    tn0.fl = 2; //设小数位为2,将数值以小数形式显示
    

说明 :单片机想显示小数,如 float value1 = 123.45。我们只需要转换一下 int value2 = value * 100, (数值控件设置2个小数位乘以100,3个就乘以1000,以此类推),然后发送value2给数值控件即可。


9.3.3. 显示数值

显示数值

  • 功能:显示整形数值。

  • 实现原理:拉出控件后默认就是显示数值,点击了其他按钮,显示格式改变了,所以需要在 弹起事件 中编写

    tn0.fmt = 0; //设tn0显示格式为数值
    tn0.fl = 0;  //小数位为0位,不显示小数
    

9.3.4. 显示货币

显示货币

  • 功能:显示货币,即在千位插入逗号分隔。

  • 实现原理:改变数值控件显示格式,在 弹起事件 中编写

    tn0.fmt = 1;//设tn0显示格式为货币
    

9.3.5. 显示十六进制

显示十六进制

  • 功能:将数值转为十六机制显示

  • 实现原理:改变数值控件显示格式,在 弹起事件 中编写

    tn0.fmt = 2;//设tn0显示格式为十六进制,不带0x
    

9.3.6. 显示带0x前缀十六进制

显示前缀十六进制

  • 功能:将数值转为十六机制(带0x前缀)显示

  • 实现原理:改变数值控件显示格式,在 弹起事件 中编写

    tn0.fmt = 3;//设tn0显示格式为十六进制,带0x