列表部件基本上是一个采用垂直布局的矩形,可向其中添加按钮和文本。
部件包含:
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:代表列表中文本的设置,字体格式以及文本大小和颜色。
下一期讲解如何为列表添加事件以及整体代码。
本文章由威三学社出品
对课程感兴趣可以私信联系