Lua 应用开发LVGL控件

ImageLabel

图标文本控件

继承自 Object

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

创建

local imglbl = parent:ImageLabel {
  src = "S:/images/icon_wifi.bin",
  text = "Wi-Fi",
  spacing = 6,
}

属性

属性类型说明
srcstring / imgsrc图标路径
textstring显示文本
fontlvgl.Font字体
spacinginteger图标与文字间距
layoutstring布局:"left", "right", "top", "bottom"
text_colorlvgl.Color文本颜色

方法

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

示例

local imglbl = lvgl.ImageLabel(nil, {
  src = "S:/images/icon_music.bin",
  text = "Music",
  layout = "right",
  spacing = 8,
  text_color = lvgl.Color(0xFFFFFF),
})

imglbl:onClicked(function
  print("ImageLabel clicked!")
end)

社区补充(洛汐文档库)

洛汐文档库记录的 ImageLabel 属性包括 src、text、font、suffix、spacing 以及一组文本样式属性;其中 suffix 为上文属性表之外的补充属性。

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

大纲