复选框控件
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
用途：复选框控件是一种用于多项选择的控件，用户可以选择一个或多个选项。每个复选框代表一个独立的选项，选中与否是独立的。

属性
---------------------------------
.. image:: image/复选框/属性.png
    :align: center
    :alt: 复选框属性

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

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


**背景属性 :**

.. image:: image/复选框/背景属性.png
    :align: center
    :alt: 复选框背景属性

|

- 背景颜色(color) : 背景颜色（读写）
- 选中颜色(color2) ：选中颜色（读写）


**特有属性 :**  
  
.. image:: image/复选框/特有属性.png
    :align: center
    :alt: 复选框特有属性

|

    - 形状(shape)：选择复选框形状，0-圆形，1-矩形
    - 选中状态(val)：当前状态值，0-未选中，1-选中(读写)

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

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

**弹起事件：** 选中状态(val)属性值为 ``0(关闭)`` 时，执行弹起事件

**按下事件：** 选中状态(val)属性值为 ``1(打开)`` 时，执行按下事件

.. attention:: 
    复选框的 ``弹起事件`` 和 ``按下事件`` 只在触摸控件时生效， 通过脚本修改 ``选中状态(val)`` 时，不会执行弹起和按下事件。

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


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

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

.. image:: image/复选框/复选框demo.png
    :align: center
    :alt: 复选框demo

|

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

|


复选框状态选择
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

- 功能：复选框切换状态时，改变文本的文字值
- 原理：

    1.在 ``弹起事件`` 中编写以下脚本

    .. code-block::
        :linenos:
    
        t0.txt.str="Unselected";//将文本设为 Unselected
    
    2.在 ``按下事件`` 中编写以下

    .. code-block::
        :linenos:
    
        t0.txt.str="Select"; //将文本设为 Select