列表部件基本上是一個采用垂直布局的矩形，可向其中添加按鈕和文本。

部件包含：
LV_PART_MAIN - 主要的屬性，大部分是這個部件。
LV_PART_SCROLLBAR - 滾動條的屬性。

（1） 添加文本
lv_obj_t * lv_list_add_text(lv_obj_t * list, const char * txt)；
上圖中的save就是添加的文本，當文本內容超過控件的寬度時，文件將發送橫向滾動。注意返回值，函數返回這一行的對象，可以用于設置事件響應點擊行為。
（2） 添加按鍵
lv_obj_t * lv_list_add_btn(lv_obj_t * list, const void * icon, const char * txt)
函數中第二個參數可以是系統符號也可以是圖片，第三個參數依舊是文本，當文本長度超過控件寬度時依然會滾動。

當參數icon為NULL時，不會添加icon，只添加txt；當txt為NULL時，則只添加icon；如果2個都是NULL時，只添加一個無顯示的btn。
（3） 修改背景顏色
lv_obj_set_style_bg_color(list1, lv_color_hex(0xff0000), LV_PART_MAIN);
將背景顏色變為紅色。
（4） 改變項的顏色
獲得對應控件的句柄來修改，通過函數lv_obj_get_child獲得句柄。
item = lv_obj_get_child(list1, 0);
lv_obj_set_style_bg_color(item, lv_color_hex(0xff0000), LV_PART_MAIN);

以下是GUI guider提供的列表的設置接口以及模塊：

Main:表示控件整體的設置，包括邊框以及背景顏色。
Scrollbar:代表滾動條的基本設置。
Button:表示列表中按鍵的設置背景顏色邊框以及按鍵大小的相關設置。
Item text:代表列表中文本的設置，字體格式以及文本大小和顏色。

下一期講解如何為列表添加事件以及整體代碼。

本文章由威三學社出品
對課程感興趣可以私信聯系