9. 数值文本控件
用途:以数值形式显示文本,支持数值、小数、货币、十六进制等。显示内容可以通过键盘修改、上位机编辑脚本修改或单片机发送指令修改。
说明:数值范围: -2147483648至2147483647 INT32_T类型
9.1. 属性
基础属性 : 参考控件概念- 基础属性
坐标属性 : 参考控件概念- 坐标属性
背景属性 : 参考控件概念- 背景属性
加载属性 : 参考控件概念- 加载属性
数值文本属性 :
数值文本控件和按钮控件的文本属性差异如下图
相同属性:
参考控件概念- 文本属性
不同属性:
自动换行(wrap):自动换行,0-否 1-是(读写)
水平间距(row):字符水平间距,单位像素,范围0-65535(读写)
垂直间距(col):字符垂直间距,单位像素,范围0-65535(读写)
- 注意:
数值文本控件相比按钮控件没有文本值属性,它是将特有属性中值(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表示无(只读)
警告
数值文本控件显示原理:使用值(val)根据显示格式显示出来。
小数位数不为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