Lua 应用开发LVGL控件

Pointer

指针(仪表指针)控件

继承自 Object

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

创建

local ptr = parent:Pointer {
  w = 160, h = 160,
  range = {
    valueStart = 0,
    valueRange = 100,
    angleStart = -120,
    angleRange = 240,
  },
  value = 30,
}

属性

属性类型说明
range{ valueStart, valueRange, angleStart, angleRange }数值到角度的线性映射
valuenumber当前指向的数值

方法

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

示例

local ptr = lvgl.Pointer(nil, {
  w = 160, h = 160,
  range = { valueStart = 0, valueRange = 100, angleStart = -120, angleRange = 240 },
  value = 30,
})

ptr:set({ value = 75 })

社区补充(洛汐文档库)

洛汐文档库示例:

local pointer = root:Pointer {
  range = {
    valueStart = 0, valueRange = 100,
    angleStart = -120, angleRange = 240,
  },
  value = 75,
}

range 定义数值到角度的线性映射,value 为当前指向数值,详见上文属性表。

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

大纲