LVGL-LED、列表

LED

lv_led_create

用于创建 LED 指示灯控件的函数

lv_obj_t * lv_led_create(lv_obj_t * parent);
//parent: 指向父对象的指针
//ret:成功时返回指向新创建的 LED 对象的指针,失败时返回 NULL (通常由于内存不足)

lv_led_set_color

用于设置 LED 控件颜色的函数

void lv_led_set_color(lv_obj_t * obj, lv_color_t color);
//obj: 指向 LED 对象的指针
//color: 要设置的 LED 颜色值，使用 lv_color_t 类型 

lv_led_set_brightness

用于设置 LED 控件亮度的函数

void lv_led_set_brightness(lv_obj_t * obj, uint8_t bright);
//obj: 指向 LED 对象的指针
//bright: 亮度值，范围为 0 到 255 的整数 

lv_led_on

用于将 LED 控件设置为开启状态的函数，它会将 LED 的亮度设置为最大值 (255)，使其显示为最亮状态

void lv_led_on(lv_obj_t * led);
//led: 指向 LED 对象的指针

lv_led_off

用于将 LED 控件设置为关闭状态的函数，它会将 LED 的亮度设置为 100（不是完全关闭的 0），使其显示为较暗状态。

void lv_led_off(lv_obj_t * led);
//led: 指向 LED 对象的指针

lv_led_toggle

用于切换 LED 控件状态的函数，它可以在 LED 的开启(ON)和关闭(OFF)状态之间进行切换

void lv_led_toggle(lv_obj_t * led);
//led: 指向 LED 对象的指针

列表

lv_list_create

用于创建列表控件的核心函数。用于显示可滚动的项目列表，通常包含文本、图标或按钮等元素。

lv_obj_t * lv_list_create(lv_obj_t * parent);
//parent: 指向父容器的指针
//ret:成功时返回指向新创建列表对象的指针,失败时返回 NULL

lv_list_add_text

用于向列表控件添加纯文本项的函数，它可以在列表中添加不可交互的文本行，常用于列表标题或分组标识

lv_obj_t * lv_list_add_text(lv_obj_t * list, const char * txt);
//list: 指向列表对象的指针
//txt: 要添加的文本字符串
//ret:成功时返回指向新创建的文本标签对象的指针,失败时返回 NULL

lv_list_add_btn

用于向列表控件添加可交互按钮项的核心函数，它可以在列表中添加包含图标和文本的可点击按钮，是构建交互式列表界面的基础

lv_obj_t * lv_list_add_btn(lv_obj_t * list, const void * icon, const char * txt);
//list: 指向列表对象的指针
//icon: 指向图标数据的指针，可以是内置符号宏(如 LV_SYMBOL_WIFI)或自定义图像对象，设为 NULL 则不显示图标 
//txt: 按钮显示的文本字符串，设为 NULL 则不显示文本
//ret:成功时返回指向新创建按钮对象的指针,失败时返回 NULL

lv_list_get_btn_text

用于获取列表按钮文本内容的函数，它可以从列表控件中的按钮项提取显示的文本字符串。

const char * lv_list_get_btn_text(lv_obj_t * list, lv_obj_t * btn);
//list: 指向列表对象的指针
//btn: 指向按钮对象的指针
//ret:成功时返回指向按钮文本字符串的指针 (UTF-8 编码),失败时返回 NULL