滑动选择控件
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
用途：日期选择、菜单选择展示等。

属性
---------------------------------
.. image:: image/滑动选择/滑动选择属性.png 
    :align: center
    :alt: 滑动选择属性

|

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

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

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

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

.. image:: image/滑动选择/滑动选择文本属性.png 
    :align: center
    :alt: 滑动选择文本属性

|

    + 文本值(str)：选项字符串，如：111\\n222\\n333\\n444，\\n是换行符，一个换行符表示一个选项。（只读）
    
    - 最大长度(size)：文本最大长度(字节),范围0-4096,UTF8编码下中文字符占用3个字节,其他编码中文字符占用2个字节,注意：键盘输入受限于此值(只读)
    
    + 字体(font)：字库id,范围0-65535,65535表示无(读写)

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

    + 选中颜色(color2)：选中字符的颜色(读写)

    **注意1：文本值(str)的换行符由多行文本编辑时自动插入的，打开多行编辑器如下图：**

    .. image:: image/滑动选择/滑动选择打开多行编辑器.png 
        :align: center
        :alt: 滑动选择打开多行编辑器    

    |

    **注意2：该控件的字库建议设为全缓存方式，且使用字库工具生成时，采用自定义字符方式。
    设置参考：** :ref:`字库全缓存什么情况需要勾选？` 

**特有属性 :**  
  
.. image:: image/滑动选择/滑动选择特有属性.png 
    :align: center
    :alt: 滑动选择特有属性

|

    + 选中项(val)：选中项，范围：0-(cnt-1),cnt为项数，cnt≤255，等于选项字符串的换行符+1。0表示第一项(读写)

    - 选中字符串(str)：选中的字符串(只读)

    + 显示横线(show)：是否显示横线:0-否 1-是(读写)

    - 横线颜色(color)：横线颜色(读写)

    + 行间距(space)：行间距,单位像素,范围:0-255(读写)

    - 循环模式(mode)：循环模式:0-非循环, 1-循环(读写)


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

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

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

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

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

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

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

.. image:: image/滑动选择/滑动选择功能演示.png 
    :align: center
    :alt: 滑动选择功能演示

|

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

|

简易菜单
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: image/滑动选择/简易菜单.png 
    :align: center
    :alt: 简易菜单

|

- 功能：点击或滑动选择菜单。
- 实现原理：

    1. 滑动选择控件tsl0使用多行文本编辑器输入菜单字符串，循环模式设为“是”
  
    .. image:: image/滑动选择/滑动选择属性配置.png 
        :align: center
        :alt: 滑动选择属性配置

    |

    2. 添加图片控件img0，导入菜单图片，并设置图片ID。

    .. image:: image/滑动选择/菜单图片.png 
        :align: center
        :alt: 菜单图片

    |

    3. 在滑动选择控件tsl0的 ``弹起事件`` 编写：
   
    ::

        img0.pic = 41 + tsl0.val; // 设置img0的图片ID
        prints("tsl0 : %s",tsl0.str); //打印选中项的文本值


|
|
|
|
|
|