滑块控件
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
用途：滑块控件是一种用于选择和调整数值范围内的某个值的控件。用户可以通过拖动滑块来选择具体的值。

属性
---------------------------------
.. image:: image/滑块/属性.png
    :align: center
    :alt: 滑块属性

|

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

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

**背景属性 :**  参考控件概念- :ref:`背景属性`

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

**特有属性 :**

.. image:: image/滑块/特有属性.png
    :align: center
    :alt: 滑块特有属性

|

    - 当前值(val) : 当前值，范围：min-max(读写)
    - 最小值(min)：最小值,范围：0-65535(读写)
    - 最小值(max)：最大值,范围：0-65535(读写)
    - 进度方向(dir)：滑块变化方向，0-水平从左向右，垂直从下向上，1-水平从右向左，垂直从上向下（读写）
    - 游标形状(kshape)：游标形状,0-圆形，1-矩形（读写）
    - 游标大小(size): 游标大小百分比，相对控件最短边的百分比，范围0-100（读写）
    - 背景宽度(bgw)：进度背景宽度百分比，相对控件最短边的百分比，范围0-100（读写）
    - 圆角(rad)：圆角弧度百分比，范围：0-100（读写）

**滑块方向说明**

    滑块的水平垂直方向由坐标属性中的 ``w`` 和 ``h`` 决定

    - 当 ``w > h`` ，滑块水平变化
    - 当 ``w < h`` ，滑块垂直变化

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

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

**弹起事件：** 控件按下且弹起后执行

**按下事件：** 控件按下后执行

**滑动事件：** 拖动滑块使滑块值改变时执行

.. attention:: 
    脚本动态修改滑块的值，不会执行滑动事件

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


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

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


|

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

|


拖动滑块实时显示当前值
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: image/滑块/滑块demo.png
    :align: center
    :alt: 滑块demo

|


- 功能：拖动滑块时实时显示当前进度值
- 原理：拖动滑块时，改变文本控件的信息


    在 ``滑动事件`` 中编写以下脚本

    .. code-block::
        :linenos:

        covx(sl0.val,t0.txt.str,0 ,0);
        t0.txt.str += "%";