14. 滑动选择控件

用途：日期选择、菜单选择展示等。

14.1. 属性

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

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

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

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

文本属性 :

• 文本值(str)：选项字符串，如：111\n222\n333\n444，\n是换行符，一个换行符表示一个选项。（只读）

• 最大长度(size)：文本最大长度(字节),范围0-4096,UTF8编码下中文字符占用3个字节,其他编码中文字符占用2个字节,注意：键盘输入受限于此值(只读)

• 字体(font)：字库id,范围0-65535,65535表示无(读写)

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

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

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

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

特有属性 :

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

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

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

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

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

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

---

14.2. 事件

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

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

---

14.3. 功能演示

点击下载演示工程

小技巧

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

14.3.1. 简易菜单

• 功能：点击或滑动选择菜单。

• 实现原理：

  1. 滑动选择控件tsl0使用多行文本编辑器输入菜单字符串，循环模式设为“是”

  

  
  

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

  

  
  

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

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