---

一、概述

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()	获取按下的按钮文本