滚动文本控件
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
用途：滚动显示文本信息。显示内容可以通过键盘修改、上位机编辑脚本修改或单片机发送指令修改。

滚动文本控件和文本控件的区别：1.增加了滚动的属性 2.无密码模式

属性
---------------------------------
.. image:: image/滚动文本/滚动文本属性.png 
    :align: center
    :alt: 滚动文本属性

|

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

**坐标属性 :**  参考控件概念- :ref:`坐标属性`
  
**背景属性 :**  参考控件概念- :ref:`背景属性`
  
**加载属性 :**  参考控件概念- :ref:`加载属性`
  
**滚动文本属性 :**  

    滚动文本控件和按钮控件的文本属性差异如下图

.. image:: image/滚动文本/滚动文本控件文本属性对比.png 
    :align: center
    :alt: 滚动文本控件文本属性对比

|

    **相同属性：** 

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

    **不同属性：**

        + 自动换行(wrap)：自动换行,0-否 1-是(读写)
        
        - 水平间距(row)：字符水平间距,单位像素,范围0-65535(读写)
        
        + 垂直间距(col)：字符垂直间距,单位像素,范围0-65535(读写)

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


**特有属性 :**  
  
.. image:: image/滚动文本/滚动文本特有属性.png 
    :align: center
    :alt: 滚动文本特有属性

|

    + 输入键盘(kb)：键盘页面id,范围0-255,255表示无（只读）

    - 滚动方向(dir)：0-从左到右 1-从右到左 2-从上到下 3-从下到上(读写)

    + 滚动速度(speed)：滚动速度,每秒滚动的像素,范围:0-65535, 0不滚动(读写)

    - 滚动使能(en)：滚动使能:0-停止 1-启动(读写)
  
    .. warning:: 
        输入键盘(kb)：文本类控件使用键盘，一定要先创建键盘页面，否则输入键盘属性无法配置。

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

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

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

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

**键盘输入结束事件：** 文本类控件使用键盘输入在关闭时执行

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

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

`点击下载演示工程 <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: 键盘输入

|

- 功能：点击滚动文本弹出键盘页面，使用键盘输入。
- 实现原理：首先，在上位机控件栏点击系统键盘创建键盘页面，然后在滚动文本控件特有属性->输入键盘属性下拉选择键盘页面。如下图：
  
.. image:: image/滚动文本/特有属性.png 
    :align: center
    :alt: 特有属性

|

    详细步骤请参考：:ref:`键盘输入` 

|

改变滚动方向
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: image/滚动文本/改变方向.png 
    :align: center
    :alt: 改变方向

|

从左向右滚动:
  - 实现原理：在按钮的 ``弹起事件`` 中编写
      
    ::

        ts0.dir = 0; //设为从左向右滚动

从右向左滚动:
  - 实现原理：在按钮的 ``弹起事件`` 中编写
      
    ::

        ts0.dir = 1;//设为从右向左滚动
        
|

启动和停止
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: image/滚动文本/改变方向.png 
    :align: center
    :alt: 改变方向

|

启动和停止:
  - 实现原理：

    1. 在按钮的 ``弹起事件`` 中编写
      
    ::

        bl0.txt.str = "停止"; //bl0的文本值设为 停止
        ts0.en = 0;//停止ts0控件滚动
        
    2. 在按钮的 ``按下事件`` 中编写
      
    ::
    
        bl0.txt.str = "启动";//bl0的文本值设为 启动
        ts0.en = 1;//启动ts0控件滚动

|
|
|
|
|
|