Lua 应用开发LVGL控件

Roller

滚轮选择控件

继承自 Object

创建

local roller = parent:Roller {
  w = 120, h = 80,
  options = {
    options = "Mon\nTue\nWed\nThu\nFri",
    mode = lvgl.ROLLER_MODE.INFINITE,
  },
  selected = { selected = 2, anim = 1 },
}

属性

属性类型说明
optionsstring 或 { options, mode }选项文本,\n 分隔;mode 为 NORMAL 或 INFINITE
selectedinteger 或 { selected, anim }选中项索引(从 0 开始),anim = 1 启用动画

方法

方法说明
get_options返回选项字符串
get_options_cnt返回选项总数
get_selected返回选中项索引
get_selected_str返回选中项文本
set(tbl)批量设置属性

示例

local roller = lvgl.Roller(nil, {
  w = 120, h = 80,
  options = "Apple\nBanana\nCherry",
  selected = { selected = 1, anim = 1 },
})

print("选中:", roller:get_selected_str)
print("总数:", roller:get_options_cnt)
roller:set({ selected = 0 })

社区补充(洛汐文档库)

洛汐文档库记录的 Roller 主要属性为 options、selected,并补充 visible_cnt(滚轮可见选项行数);选项与选中项的读取通过通用 set 及选择读取方法(get_options / get_options_cnt / get_selected / get_selected_str,见上)完成。

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

大纲