AIGame
API英文文档
API中文文档
UI英文文档
UI中文文档
API英文文档
API中文文档
UI英文文档
UI中文文档

滑动条

  • 更新时间:2025-12-02 10:12:47

滑动条-slider

原生类型:{com.google.android.material.slider.Slider}

滚动条：常用于动态设置数字参数，通过滑动就可以变换数值。

一、常用属性

开始值 - 开始值

设置开始值

<滑动条 开始值="0" />

结束值 - 结束值

设置结束值

<滑动条 结束值="100" />

当前值 - 初始值

设置初始值

<滑动条 当前值="30" />

进步值 - 进步值

设置进步值

<滑动条 进步值="1" />

主题颜色 - 主题颜色

设置主题颜色

<滑动条 主题颜色="#FF0000" />

标签 - 标签文字

设置标签文字

<滑动条 标签="进度:" />

标签尾部 - 标签文字尾部

设置标签文字尾部

<滑动条 标签尾部="个" />

内边距 - 内边距

设置内边距

参数顺序:左,上,右,下(单位:dp)

<滑动条 内边距="20,20,20,20" />

背景颜色 - 背景颜色

设置背景颜色

<滑动条 背景颜色="#1E1F22" />

背景图片 - 背景图片

设置背景图片

<滑动条 背景图片="./资源/图片.png" />

二、常用函数

设置背景颜色(颜色)

设置背景颜色

  • 参数 : 颜色 {数字} 文本颜色值

  • 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滚动条 = 界面.找控件("我的滚动条");
//设置背景颜色
滚动条.设置背景颜色($颜色.红色);

设置背景颜色(颜色)

设置背景颜色

  • 参数 : 颜色 {字符串} 颜色字符串

  • 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滚动条 = 界面.找控件("我的滚动条");
//设置背景颜色
滚动条.设置背景颜色("#1E1F22");

设置主题颜色(颜色)

设置主题颜色

  • 参数 : 颜色 {数字} 文本颜色值

  • 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滚动条 = 界面.找控件("我的滚动条");
//设置主题颜色
滚动条.设置主题颜色($颜色.红色);

设置主题颜色(颜色)

设置主题颜色

  • 参数 : 颜色 {字符串} 颜色字符串

  • 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滚动条 = 界面.找控件("我的滚动条");
//设置主题颜色
滚动条.设置主题颜色("#1E1F22");

标签格式化(回调)

设置标签格式化

  • 参数 : 回调 {(浮点值)=>{ return "标签"; }} 格式化回调

监听变化(回调)

监听数值变化

注意:只监听由用户手动触发的数值变化,若为编程时设置的数值,则忽略

  • 参数 : 回调 {(数值)=>{}}

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//监听数值变化
滑动条.监听变化((数值)=>{
    //..
});

获取值()

获取当前值

  • 返回 : {float} 当前数值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//获得当前值
定义 当前值 = 滑动条.获取值();

设置值(数值)

设置当前值

  • 参数 : 数值 {float} 当前值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置当前值
滑动条.设置值(10);

设置开始值(开始值)

设置开始值

  • 参数 : 开始值 {float} 开始值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置开始值
滑动条.设置开始值(0);

设置进步值(进步值)

设置进步值

  • 参数 : 进步值 {float} 进步值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置进步值
滑动条.设置进步值(1);

设置结束值(结束值)

设置结束值

  • 参数 : 结束值 {float} 结束值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置结束值
滑动条.设置结束值(100);

设置数据(开始, 结束)

设置数据

  • 参数 : 开始 {float} 开始值

  • 参数 : 结束 {float} 结束值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置数据(开始,结束)
滑动条.设置数据(0,100);

设置数据(开始, 结束, 当前值)

设置数据

  • 参数 : 开始 {float} 开始值

  • 参数 : 结束 {float} 结束值

  • 参数 : 当前值 {float} 当前值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 滑动条 = 界面.找控件("我的滑动条");
//设置数据(开始,结束,当前值)
滑动条.设置数据(0,100,20);
ON THIS PAGE