Lua 应用开发LVGL控件

ImageLineBar

线性图片进度条控件

继承自 Object

⚠️ 该控件在模拟器的 debug.getregistry["widgets"] 中未注册,可能仅在特定硬件设备上可用。API 签名基于源码分析,待设备验证。

创建

local linebar = parent:ImageLineBar {
  w = 240, h = 20,
  src_bg = "S:/images/line_bg.bin",
  src_fg = "S:/images/line_fg.bin",
  value = 50,
}

属性

属性类型说明
src_bgstring / imgsrc背景图片
src_fgstring / imgsrc前景图片
valueinteger当前值(0~100)
segmentsinteger线段数量
spacinginteger线段间距(像素)
directionstring方向:"left", "right", "top", "bottom"
range{min, max}值范围
color_activelvgl.Color已填充颜色
color_inactivelvgl.Color未填充颜色

方法

方法说明
set(tbl)批量设置属性

示例

local linebar = lvgl.ImageLineBar(nil, {
  w = 240, h = 20,
  src_bg = "S:/images/line_bg.bin",
  src_fg = "S:/images/line_fg.bin",
  value = 80,
  segments = 10,
  spacing = 2,
})

linebar:set({ value = 50 })

社区补充(洛汐文档库)

洛汐文档库补充的 ImageLineBar 范围属性:

属性说明
start_x, start_y线段起点坐标
end_x, end_y线段终点坐标
value当前值(见上)

图片源通过 src_bg / src_fg 属性指定(见上)。

参考来源:官方 docs-lua / 洛汐文档库

大纲