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

进度条

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

进度条-progress

圆形原生类型:{com.google.android.material.progressindicator.CircularProgressIndicator} 线性原生类型:{com.google.android.material.progressindicator.LinearProgressIndicator}

进度条：比如下载进度，游戏进度，进度条就是用来显示进度的控件

<ui>
    <statusbar />
    <linear w="max" padding="10">
        <linear w="max" dir="h">
            <progress w="max" padding="10" run="true" />
            <progress w="max" color="#518855" padding="10" run="true" />
            <progress w="max" color="#B44A4A" padding="10" run="true" />
        </linear>
        <progress w="max" style="line" run="true" padding="10" />
        <progress w="max" style="line" color="#518855" padding="10" run="true" />
        <progress w="max" style="line" color="#B44A4A" padding="10" run="true" />
    </linear>
</ui>

一、基础用法

<ui>
    <statusbar />
    <linear w="max" padding="10">
        <!-- 指定进度条的id -->
        <progress id="circularProgress" w="max"/>
        <progress id="lineProgress" w="max" style="line"/>
    </linear>
</ui>
//解析布局
let ui = $ui.layout("ui.xml");
ui.show();//显示界面
//获取圆形/线性进度条
let cp = ui.id("circularProgress");
let lp = ui.id("lineProgress");
//动态模拟进度条的走动
for (let i = 1; i <= 10; i++) {
    sleep(150);
    //[核心]:设置进度
    cp.setProgress(i * 10);
    lp.setProgress(i * 10);
}

二、常用属性

可见 - 可见性

设置可见性

<进度条 可见="否" />

风格 - 样式

设置样式

<进度条 风格="直线" />

厚度 - 厚度

设置厚度

<进度条 厚度="10" />

动画 - 动画

设置动画

<进度条 动画="是" />

颜色 - 颜色

设置颜色

<进度条 颜色="#FF0000" />

最小宽度 - 最小宽度

设置最小宽度

<进度条 最小宽度="100" />

最小高度 - 最小高度

设置最小高度

<进度条 最小高度="100" />

内边距 - 内边距

设置内边距

<进度条 内边距="0,0,0,0" />

背景颜色 - 背景颜色

设置背景颜色

<进度条 背景颜色="#1E1F22" />

背景图片 - 背景图片

设置背景图片

<进度条 背景图片="./资源/图片01.png" />

三、常用函数

设置进度(进度值)

设置进度

此方法需要安卓7.0以上生效

  • 参数 : 进度值 {int} 进度值(0-100)

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 进度条 = 界面.找控件("我的进度条");
//设置进度
进度条.设置进度(50);

设置最大值(最大值)

设置最大进度

  • 参数 : 最大值 {int} 最大进度值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 进度条 = 界面.找控件("我的进度条");
//设置最大进度
进度条.设置最大值(100);

获取进度()

获取进度

  • 返回 : {int} 当前进度值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 进度条 = 界面.找控件("我的进度条");
//获得进度
定义 进度 = 进度条.获取进度();

显示()

显示进度条

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 进度条 = 界面.找控件("我的进度条");
//显示进度条
进度条.显示();

隐藏()

隐藏进度条

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 进度条 = 界面.找控件("我的进度条");
//隐藏进度条
进度条.隐藏();
ON THIS PAGE