8. 滚动文本控件

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

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

8.1. 属性

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

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

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

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

滚动文本属性 :

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

相同属性：

参考控件概念- 文本属性

不同属性：

自动换行(wrap)：自动换行,0-否 1-是(读写)

水平间距(row)：字符水平间距,单位像素,范围0-65535(读写)

垂直间距(col)：字符垂直间距,单位像素,范围0-65535(读写)

注意：滚动文本的字库建议设为全缓存方式，且使用字库工具生成时，采用自定义字符方式。

设置参考： 字库全缓存什么情况需要勾选？

特有属性 :

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

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

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

滚动使能(en)：滚动使能:0-停止 1-启动(读写)

警告

输入键盘(kb)：文本类控件使用键盘，一定要先创建键盘页面，否则输入键盘属性无法配置。

8.2. 事件

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

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

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

8.3. 功能演示

点击下载演示工程

小技巧

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

8.3.1. 键盘输入

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

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

8.3.2. 改变滚动方向

从左向右滚动:

实现原理：在按钮的 弹起事件 中编写
```
ts0.dir = 0; //设为从左向右滚动
```

从右向左滚动:

实现原理：在按钮的 弹起事件 中编写
```
ts0.dir = 1;//设为从右向左滚动
```

8.3.3. 启动和停止

启动和停止:

实现原理：

在按钮的 弹起事件 中编写

bl0.txt.str = "停止"; //bl0的文本值设为 停止
ts0.en = 0;//停止ts0控件滚动

在按钮的 按下事件 中编写

bl0.txt.str = "启动";//bl0的文本值设为 启动
ts0.en = 1;//启动ts0控件滚动