状态开关控件
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
用途：状态开关控件是一种用于切换状态的控件，通常用于表示两种状态之间的切换，如开关灯、启用/禁用等。

属性
---------------------------------
.. image:: image/状态开关/属性.png
    :align: center
    :alt: 状态开关控件属性

|

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

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

**状态0背景属性 :**  

.. image:: image/状态开关/状态0背景属性.png
    :align: center
    :alt: 状态开关状态0背景属性

|

- 背景颜色(color) : 状态0背景颜色（读写）
- 前景颜色(color2) ：状态0前景颜色（读写）

**状态1背景属性 :**  

.. image:: image/状态开关/状态1背景属性.png
    :align: center
    :alt: 状态开关状态1背景属性

|

- 背景颜色(color) : 状态1背景颜色（读写）
- 前景颜色(color2) ：状态1前景颜色（读写）


**特有属性 :**  
  
.. image:: image/状态开关/特有属性.png
    :align: center
    :alt: 状态开关特有属性

|

    - 状态值(val)：当前状态值，0-关闭，1-打开(读写)
    - 圆形大小(size)：状态开关中圆形的大小，相对于最短边的百分比，范围0-255，0-100是缩小，101-255是放大（读写）

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

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

**弹起事件：** 状态值(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="stop";//将文本设为stop
    
    2.在 ``按下事件`` 中编写以下

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