数值键盘控件
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
用途：文本类控件（文本、滚动文本、数值文本、图片数值）输入数值。它是一个页面类型的控件，创建后，文本类控件就可以绑定它，然后点击文本控件就会弹出键盘。

注意：使用键盘输入，要规划好文本控件的size大小，否则，如size=5,输入了6个字符会显示不全！

说明：数值键盘控件严格意义上是一个编辑好的页面，它由1个数值键盘页面 +  17个键盘按钮 + 1个显示文本组成。如下图所示：

.. image:: image/数值键盘/数值键盘组成.png 
    :align: center
    :alt: 数值键盘组成

|

数值键盘按键说明：

.. image:: image/数值键盘/数值键盘按键说明.png 
    :align: center
    :alt: 数值键盘按键说明

|

属性
---------------------------------

**数值键盘页面属性：**

.. image:: image/数值键盘/数值键盘页面属性.png 
    :align: center
    :alt: 数值键盘页面属性

|

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

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

**背景属性 :**  

    + 默认图片(pic)：默认图片id,范围0-65535,65535表示无(读写)

    - 按下图片(pic2)：按下图片id,范围0-65535,65535表示无(读写)

    **注意：键盘控件无事件，属性描述中的读写、只读无意义**

    数值键盘添加后系统会自动添加所需的图片，如下图所示：
    
.. image:: image/数值键盘/数值键盘自动创建图片.png 
    :align: center
    :alt: 数值键盘自动创建图片
 
|

.. hint:: 
    - 用户可自行替换图片，改为自己想要键盘风格样式。
  
---------------------------------

**键盘按钮属性：**

    请参考：:ref:`键盘按钮控件` 

|

---------------------------------

**显示文本属性：**

.. image:: image/数值键盘/数值键盘显示文本属性.png 
    :align: center
    :alt: 数值键盘显示文本属性

|

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

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

**文本属性 :**  

    + 字体(font)：字库id,范围0-65535,65535表示无(读写)

    - 水平对齐方式(alx)：水平对齐,0-靠左 1-居中 2-靠右(读写)

    + 本颜色(color)：文本默认颜色(读写)

    - 光标颜色(curcol)：光标颜色(只读)

    **注意：键盘控件无事件，属性描述中的读写、只读无意义**

    数值键盘添加后系统会自动添加显示文本控件所需的字库所示：
    
.. image:: image/数值键盘/创建键盘的字库.png 
    :align: center
    :alt: 创建键盘的字库
 
|

.. hint:: 
    - 用户可自行替换字库，改为自己想要的字体样式。

.. warning:: 
    - 显示文本控件是键盘页面专属的，其他用户页面无法添加。
    - 键盘页面只有一个显示文本控件，而且不能被删除。

---------------------------------

事件
---------------------------------

无。 键盘控件自身无事件，但在关闭键盘时，会触发弹出键盘的文本类控件的输入完成事件。

---------------------------------

功能演示
---------------------------------

`点击下载演示工程 <http://www.openedv.com/ATK-Prod/ATK-HMI/file_download/wid_demo/project(wid_demo).zip>`_

|

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

|
|
|
|
|
|