拖动条

  • 更新时间:2026-03-17 19:34:33

拖动条-seek

该组件比slider更加小巧,属于安卓原生组件。

原生类型:{android.widget.SeekBar}

一、常用属性

from - 开始值

设置开始值

<seek from="0" />

to - 结束值

设置结束值

<tab to="100" />

value - 当前值

设置当前值

<tab value="30" />

padding - 内边距

设置内边距

<!--padding顺序是:左,上,右,下-->
<!--padding只设置一个值:则设置所有方向的内边距-->
<!--padding只设置两个值:则设置左右和上下方向的内边距-->
<tab seek="20" />

bg - 背景颜色

设置背景颜色

<tab seek="#1E1F22" />

bgImg - 背景图片

设置背景图片

<tab seek="./img.png" />

二、常用函数

监听变化(回调)

监听数值变化

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

  • 参数 : 回调 {(数值)=>{}}
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//监听数值变化
拖动条.监听变化((数值)=>{
    //..
});
//取消监听 拖动条.监听变化(null);

监听触摸开始(回调)

监听触摸开始

用户用手指滑动时,当触摸开始时回调。若要取消监听,则设置为null即可。

  • 参数 : 回调 {()=>{}} 回调
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//监听触摸开始
拖动条.监听触摸开始(()=>{
    //..
});

监听触摸结束(回调)

监听触摸结束

用户用手指滑动时,当触摸结束时回调。若要取消监听,则设置为null即可。

  • 参数 : 回调 {()=>{}} 回调
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//监听触摸结束
拖动条.监听触摸结束(()=>{
    //..
});

获取最小值()

获取最小值

在安卓8.0以上的设备中,会获取最小值,否则就获取当前进度。

  • 返回 : {数字} 最小值
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//获取最小值
定义 最小值 = 拖动条.获取最小值();

获取最大值()

获取最大值

  • 返回 : {数字} 最大值
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//获取最大值
定义 最大值 = 拖动条.获取最大值();

设置值(数值)

设置当前值

  • 参数 : 数值 {float} 当前值
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//设置当前值
拖动条.设置值(10);

获取值()

获取当前值

  • 返回 : {float} 当前数值
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//获得当前值
定义 当前值 = 拖动条.获取值();

设置开始值(开始值)

设置开始值

  • 参数 : 开始值 {float} 开始值
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//设置开始值
拖动条.设置开始值(0);

设置结束值(结束值)

设置结束值

  • 参数 : 结束值 {float} 结束值
  • 版本 : 1.9.5
//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 拖动条 = 界面.找控件("我的拖动条");
//设置结束值
拖动条.设置结束值(100);