滚轮

1. 概述

滚轮控件用于配置可滚动的列表资源。用户可以设置滚轮的各种属性,如位置、尺寸、数据绑定、类型、滚动方向等,并生成符合要求的滚轮资源文件,供固件解析并使用。

创建路径:基本>滚轮

2. 界面参数说明

2.1 基本信息

  • ID:滚轮控件的唯一ID,用于固件代码查找UID,用户可以根据需求修改

    • 默认值:roller_xxx. 创建控件时自动生成

    • 格式要求:

      • 只能包含字母、数字和下划线

      • 长度不能超过15个字符

  • UID:滚轮资源的唯一标识符,用于固件代码查找滚轮控件。系统自动生成,用户无需手动设置。

    • 特征值:以0E开头

2.2 位置和尺寸

  • 位置 x:滚轮在容器中的X坐标位置

  • 位置 y:滚轮在容器中的Y坐标位置

  • 尺寸 w:滚轮的宽度

  • 尺寸 h:滚轮的高度

注意:控件范围不能超过父控件范围,否则可能导致显示异常或生成报错。

2.3 对齐控件

  • 对齐控件:设置图像在容器中的对齐方式。(目前不支持)

2.4 数据绑定

  • 数据绑定:点击右侧的"+"按钮可以添加数据绑定

2.5 类型

  • 类型:设置滚轮的类型(文本、图片、数值、数值-图组)

2.6 滚动方向

  • 滚动方向:设置滚轮的滚动方向(横向、纵向)

2.7 功能设置

  • 支持滚轮:勾选此选项可以启用物理滚轮来滚动此滚轮控件

  • 选中高亮:勾选此选项可以启用选中项高亮显示

2.8 模版

  • 模版:暂无

2.9 内容项设置

  • 数量:滚轮中显示的内容项数量,取决于绑定的数据源的范围

  • 当纵向滚动时为例

    • :设置滚轮内容项的宽度,建议与控件宽度相同

    • :设置滚轮内容项的高度,此项会影响滚轮中显示的内容项数量。内容项的数量减一乘以内容项的高度需要大于控件高度,否则无法滚动。

    • 间隔:设置滚轮内容项之间的间隔

2.10 文本类型

滚动项的内容是由用户自定义的文本内容。

  • 文本:设置滚轮中显示的文本内容,使用分号分隔多个文本项,最后一个文本项后不能有分号。有多少个滚动项就要设置多少个文本项。

  • 数值:自动生成,无需修改

  • 颜色(ARGB):设置滚动项中文本的颜色

  • 字号:设置滚动项中文本的字号

2.11 图片类型

滚动项的内容是由用户自定义的图片资源。

  • 图片源:点击选择图片源。仅支持PNG图片。数量等于滚动项的数量。每一项都需要设置一个图片源。

2.12 数值类型

滚动项的内容是数值列表中的内容,无法修改。取决于数据源的取值范围。

  • 数值:自动生成,无需修改

  • 颜色(ARGB):设置滚动项中数值的颜色

  • 字号:设置滚动项中数值的字号

2.13 数值-图组类型

滚动项的内容是由用户自定义的数值和图片资源的组合

  • 图片源:需要填入0-9的数字图片

3. 演示视频