合宙Air724UG LuatOS-Air LVGL API控件--进度条 (Bar)

进度条 (Bar)

Bar 是进度条,可以用来显示数值,加载进度。

示例代码

-- 创建进度条

bar = lvgl.bar_create(lvgl.scr_act(), nil)

-- 设置尺寸

lvgl.obj_set_size(bar, 200, 20);

-- 设置位置居中

lvgl.obj_align(bar, NULL, lvgl.ALIGN_CENTER, 0, 0)

-- 设置加载完成时间

lvgl.bar_set_anim_time(bar, 2000)

-- 设置加载到的值

lvgl.bar_set_value(bar, 100, lvgl.ANIM_ON)

创建

可以通过 lvgl.bar_create(par, copy) 创建一个进度条对象然后对其进行操作。

-- 创建控件

bar = lvgl.bar_create(lvgl.scr_act(), nil)

设置数值

进度条的用法还是比较简单的,功能比较单一,只是设置数值。

lvgl.bar_set_value(bar, 50, lvgl.ANIM_OFF)

虽然翻译为了进度条,但是不要以为它的满量程只能是 100 (虽然这是个默认数值),进度条的数值范围也是可以设置的,比如下面的代码:

lvgl.bar_set_range(bar, 100, 200)

lvgl.bar_set_value(bar, 150, lvgl.ANIM_OFF)

这个就是把进度条的数值范围设置到了 100-200,所以 150 就是进度条的中间,跟上面的显示效果一样的。

动画

进度条设置的值可以是实时的,当然也可以是有延时的,可以通过 lvgl.ANIM_OFF lvgl.ANIM_ON 这两个值来决定是否显示设置值的一个中间效果。通过 lvgl.bar_set_anim_time 可以设置加载时间。

-- 设置加载完成时间

lvgl.bar_set_anim_time(bar, 2000)

-- 设置加载到的值

lvgl.bar_set_value(bar, 100, lvgl.ANIM_ON)

上面代码就是设置了 2秒 走完整个进度条:

进度条起始值也可以添加动画,录制有点卡,实际还是很流畅的。

-- 设置进度条起始值

lvgl.bar_set_start_value(bar, 100, lvgl.ANIM_ON)

sys.wait(2000)

-- 设置加载完成时间

lvgl.bar_set_anim_time(bar, 2000)

-- 设置加载到的值

lvgl.bar_set_value(bar, 100, lvgl.ANIM_ON)

获取属性

进度条控件设置的很多值都可以通过 get 获取,具体使用情况可以参照 API。

API

lvgl.bar_create

调用 lvgl.bar_create(par, copy)

功能 创建一个进度条对象

返回 指向创建的进度条的指针

参数

par 指向对象的指针, 它将是新键对象的父对象

copy 指向进度条对象的指针, 如果不为 nil, 则将从其复制新对象

lvgl.bar_set_value

调用 lvgl.bar_set_value(bar, value, anim)

功能 在进度条上设置新值

参数

bar 指向进度条对象的指针

value 新数值

anim lvgl.ANIM_ON 用动画设置值。lvgl.ANIM_OFF 立即更改值。

lvgl.bar_set_start_value

调用 lvgl.bar_set_start_value(bar, start_value, anim)

功能 在进度条上设置新的起始值

参数

bar 指向进度条对象的指针

value 新的起始值

anim lvgl.ANIM_ON 用动画设置值。lvgl.ANIM_OFF 立即更改值。

lvgl.bar_set_range

调用 lvgl.bar_set_range(bar, min, max)

功能 设置进度条的最小值和最大值

参数

bar 指向进度条对象的指针

min 最小值

max 最大值

lvgl.bar_set_type

调用 lvgl.bar_set_type(bar, type)

功能 设置进度条的类型。

参数

bar 指向进度条对象的指针

type 进度条类型

lvgl.BAR_TYPE_NORMAL

lvgl.BAR_TYPE_SYMMETRICAL

lvgl.BAR_TYPE_CUSTOM

lvgl.bar_set_anim_time

调用 lvgl.bar_set_anim_time(bar, anim_time)

功能 设置进度条的动画时间

参数

bar 指向进度条对象的指针

anim_time 动画时间(以毫秒为单位)。

lvgl.bar_get_value

调用 lvgl.bar_get_value(bar)

功能 获取进度条的数值

返回 进度条的数值

参数

bar 指向进度条对象的指针

lvgl.bar_get_start_value

调用 lvgl.bar_get_start_value(bar)

功能 获取进度条的起始值

返回 进度条的起始值

参数

bar 指向进度条对象的指针

lvgl.bar_get_min_value

调用 lvgl.bar_get_min_value(bar)

功能 获取进度条的最小值

返回 进度条的最小值

参数

bar 指向进度条对象的指针

lvgl.bar_get_max_value

调用 lvgl.bar_get_max_value(bar)

功能 获取条形的最大值

返回 进度条的最大值

参数

bar 指向进度条对象的指针

lvgl.bar_get_type

调用 lvgl.bar_get_type(bar)

功能 获取进度条的类型。

返回 进度条类型

参数

bar 指向进度条对象的指针

lvgl.bar_get_anim_time

调用 lvgl.bar_get_anim_time(bar)

功能 获取进度条的动画时间

返回 动画时间(以毫秒为单位)。

参数

bar 指向进度条对象的指针

参考链接(C语言)

相关推荐
l5317981511 年前
合宙Air724UG LuatOS-Air lvgl字库
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-截屏(Screenshots)
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-图片(Gif)
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-二维码(Qrcode)
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-标签 (Label)
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-窗口 (Window)
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-图片 (Image)
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-表格(Table)
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-开关 (Switch)
air724ug
l5317981511 年前
合宙Air724UG LuatOS-Air LVGL API控件-页面 (Page)
air724ug