一、概述
List(列表) 基本上是一个垂直布局的矩形,按钮指向该矩形并且可以添加文本。
列表部件由两个部分组成:
LV_PART_MAIN
使用所有典型背景属性的列表的主要部分LV_PART_SCROLLBAR
滚动条。
二、列表
1、添加列表按钮
在默认的情况下,列表部件被创建出来后,只有一个矩形背景框,并没有任何的文本和按钮,用户需要自行往列表里面添加按钮,添加按钮的相关函数为 lv_list_add_btn
。
lv_obj_t *list = lv_list_create(lv_scr_act()); /* 创建列表 */
lv_obj_set_width(list, 200); /* 设置列表宽度 */
lv_obj_set_height(list, 150); /* 设置列表高度 */
lv_obj_center(list);
lv_obj_t *btn;
btn = lv_list_add_btn(list, NULL, "lst1"); /* 添加按钮 */
btn = lv_list_add_btn(list, NULL, "lst2"); /* 添加按钮 */
我们也可以为其添加图标:
图标类型参阅 LVGL 控件之标签(lv_label)
lv_obj_t *list = lv_list_create(lv_scr_act()); /* 创建列表 */
lv_obj_set_width(list, 200); /* 设置列表宽度 */
lv_obj_set_height(list, 150); /* 设置列表高度 */
lv_obj_center(list);
lv_obj_t *btn;
btn = lv_list_add_btn(list, LV_SYMBOL_FILE, "New"); /* 添加按钮 */
btn = lv_list_add_btn(list, LV_SYMBOL_DIRECTORY, "Open"); /* 添加按钮 */
2、设置列表文本
列表文本主要用于一类按钮的功能提示或按钮分类。用户需要添加列表文本,可调用 lv_list_add_text
函数进行设置,该函数有两个形参,第一个形参指向列表对象,第二个形参表示设置的文本。
lv_obj_t* list = lv_list_create(lv_scr_act()); /* 创建列表 */
lv_obj_set_width(list, 200); /* 设置列表宽度 */
lv_obj_set_height(list, 200); /* 设置列表高度 */
lv_obj_center(list);
lv_obj_t* btn;
lv_list_add_text(list, "File"); /* 列表添加标签 */
btn = lv_list_add_btn(list, LV_SYMBOL_FILE, "New"); /* 添加按钮 */
btn = lv_list_add_btn(list, LV_SYMBOL_DIRECTORY, "Open"); /* 添加按钮 */
lv_list_add_text(list, "Direction"); /* 列表添加标签 */
btn = lv_list_add_btn(list, LV_SYMBOL_UP, "Up"); /* 添加按钮 */
btn = lv_list_add_btn(list, LV_SYMBOL_DOWN, "Down"); /* 添加按钮 */
3、API 函数
函数 | 描述 |
---|---|
lv_list_create() | 创建列表部件 |
lv_list_add_text() | 添加列表文本 |
lv_list_add_btn() | 添加列表按钮 |
lv_list_get_btn_text() | 获取按下的按钮文本 |