数值文本控件 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 用途：以数值形式显示文本，支持数值、小数、货币、十六进制等。显示内容可以通过键盘修改、上位机编辑脚本修改或单片机发送指令修改。 说明：数值范围: -2147483648至2147483647 INT32_T类型 属性 --------------------------------- .. image:: image/数值文本/数值文本属性.png :align: center :alt: 数值文本属性 | **基础属性 :** 参考控件概念- :ref:`基础属性` **坐标属性 :** 参考控件概念- :ref:`坐标属性` **背景属性 :** 参考控件概念- :ref:`背景属性` **加载属性 :** 参考控件概念- :ref:`加载属性` **数值文本属性 :** 数值文本控件和按钮控件的文本属性差异如下图 .. image:: image/数值文本/数值文本控件文本属性对比.png :align: center :alt: 数值文本控件文本属性对比 | **相同属性：** 参考控件概念- :ref:`文本属性` **不同属性：** + 自动换行(wrap)：自动换行,0-否 1-是(读写) - 水平间距(row)：字符水平间距,单位像素,范围0-65535(读写) + 垂直间距(col)：字符垂直间距,单位像素,范围0-65535(读写) **注意:** 1. 数值文本控件相比按钮控件没有文本值属性，它是将特有属性中值（val）以数值形式显示出来。 **特有属性 :** .. image:: image/数值文本/数值文本特有属性.png :align: center :alt: 数值文本特有属性 | + 值(val)：整数数值,范围: -2147483648至2147483647 INT32_T类型 (读写) **注意：** 不支持输入小数，否则上位机弹出提示窗口，如下图： .. image:: image/数值文本/数值文本输入小数报错.png :align: center :alt: 数值文本输入小数报错 | - 显示格式(fmt)：显示格式:0-数值 1-货币 2-十六进制 3-带0x前缀十六进制(读写) + 显示长度(len)：显示长度:范围0-11,0为自动(读写) - 整数位数(il)：整数位数,范围：0-11,0表示自动,仅小数位数为0有效（读写） + 小数位数(fl)：小数位数,范围：0-8,0表示无小数（读写） - 输入键盘(kb)：键盘页面id,范围0-255,255表示无（只读） .. warning:: 1. 数值文本控件显示原理：使用值（val）根据显示格式显示出来。 2. 小数位数不为0，脚本获取到val并不是小数，始终是整数。如：val=1024; fl=2;脚本获取val，不是10.24而是1024。 .. warning:: 输入键盘(kb)：文本类控件使用键盘，一定要先创建键盘页面，否则输入键盘属性无法配置。 --------------------------------- 事件 --------------------------------- **弹起事件：** 控件按下且弹起后执行 **按下事件：** 控件按下后执行 **键盘输入结束事件：** 文本类控件使用键盘输入在关闭时执行 --------------------------------- 功能演示 --------------------------------- `点击下载演示工程 `_ .. image:: image/数值文本/数值文本功能演示.png :align: center :alt: 数值文本功能演示 | .. tip:: 把工程配置的启动页面(pid)改为当前页面ID可以立即显示此页面。 | 键盘输入 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: image/数值文本/键盘输入.png :align: center :alt: 键盘输入 | - 功能：点击文本弹出键盘页面，使用键盘输入。 - 实现原理：首先，在上位机控件栏点击系统键盘创建键盘页面，然后在文本控件特有属性->输入键盘属性下拉选择键盘页面。如下图： .. image:: image/数值文本/特有属性.png :align: center :alt: 特有属性 | 详细步骤请参考：:ref:`键盘输入` | 显示小数 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: image/数值文本/显示小数.png :align: center :alt: 显示小数 | - 功能：将数值以小数形式显示出来。 - 实现原理：在 ``弹起事件`` 中编写 :: tn0.fl = 2; //设小数位为2，将数值以小数形式显示 **说明** ：单片机想显示小数，如 float value1 = 123.45。我们只需要转换一下 int value2 = value * 100， （数值控件设置2个小数位乘以100，3个就乘以1000，以此类推），然后发送value2给数值控件即可。 | 显示数值 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: image/数值文本/显示数值.png :align: center :alt: 显示数值 | - 功能：显示整形数值。 - 实现原理：拉出控件后默认就是显示数值，点击了其他按钮，显示格式改变了，所以需要在 ``弹起事件`` 中编写 :: tn0.fmt = 0; //设tn0显示格式为数值 tn0.fl = 0; //小数位为0位，不显示小数 | 显示货币 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: image/数值文本/显示货币.png :align: center :alt: 显示货币 | - 功能：显示货币，即在千位插入逗号分隔。 - 实现原理：改变数值控件显示格式，在 ``弹起事件`` 中编写 :: tn0.fmt = 1;//设tn0显示格式为货币 | 显示十六进制 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: image/数值文本/显示十六进制.png :align: center :alt: 显示十六进制 | - 功能：将数值转为十六机制显示 - 实现原理：改变数值控件显示格式，在 ``弹起事件`` 中编写 :: tn0.fmt = 2;//设tn0显示格式为十六进制，不带0x | 显示带0x前缀十六进制 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. image:: image/数值文本/显示前缀十六进制.png :align: center :alt: 显示前缀十六进制 | - 功能：将数值转为十六机制（带0x前缀）显示 - 实现原理：改变数值控件显示格式，在 ``弹起事件`` 中编写 :: tn0.fmt = 3;//设tn0显示格式为十六进制，带0x | | | | | | |