LVGL-下拉列表
lv_dropdown_create函数用于创建下拉菜单
lv_obj_t * lv_dropdown_create(lv_obj_t * parent);
//parent:下拉菜单的父对象
//ret:返回创建的下拉菜单对象的指针lv_dropdown_set_text函数
设置下拉菜单按钮文本
void lv_dropdown_set_text(lv_obj_t * obj, const char * txt);
//obj：指向下拉菜单对象的指针
//txt：要设置的文本内容.如果设置为 NULL，则按钮上会显示当前选中的选项文本lv_dropdown_set_options函数
设置下拉菜单选项
void lv_dropdown_set_options(lv_obj_t * obj, const char * options);
//obj：指向下拉菜单对象的指针
//options：一个以 \n 分隔的字符串，包含所有选项lv_dropdown_set_options_static函数
用于设置下拉菜单选项的函数，它允许从静态（常量）字符串中设置选项，从而节省内存
void lv_dropdown_set_options_static(lv_obj_t * obj, const char * options);
//obj：指向下拉菜单对象的指针
//options：一个以 \n 分隔的字符串，包含所有选项lv_dropdown_add_option函数
用于向下拉菜单动态添加选项的函数。它允许在运行时向已存在的下拉菜单中插入新的选项，而无需重新设置整个选项列表
void lv_dropdown_add_option(lv_obj_t * obj, const char * txt, uint8_t pos);
//obj：指向下拉菜单对象的指针
//txt：要添加的选项文本
//pos：选项插入的位置，从 0 开始。如果 pos 超出当前选项的数量，选项将被添加到末尾。lv_dropdown_clear_options函数
用于清空下拉菜单所有选项的函数。它允许开发者在运行时动态地移除下拉菜单中的所有选项，从而可以重新设置选项或根据需要更新下拉菜单的内容。
void lv_dropdown_clear_options(lv_obj_t * obj);
//obj：指向下拉菜单对象的指针lv_dropdown_set_selected函数
用于设置下拉菜单当前选中项的函数。它允许开发者在运行时动态地更改下拉菜单中显示的选项。
void lv_dropdown_set_selected(lv_obj_t * obj, uint16_t sel);
//obj：指向下拉菜单对象的指针
//sel：要设置为选中的选项的索引，从 0 开始。如果索引超出范围，不会报错，但不会更改选中项。lv_dropdown_set_dir函数
设置下拉菜单展开方向,控制下拉菜单的展开方向，例如向下、向上、向左或向右
void lv_dropdown_set_dir(lv_obj_t * obj, lv_dir_t dir);
/*
obj：指向下拉菜单对象的指针
dir：展开方向，类型为 lv_dir_t 枚举值
LV_DIR_BOTTOM：向下展开（默认方向）。
LV_DIR_TOP：向上展开。
LV_DIR_LEFT：向左展开。
LV_DIR_RIGHT：向右展开
*/lv_dropdown_set_symbol函数
用于设置下拉菜单（Dropdown）的符号（例如箭头）的函数。这个符号通常显示在下拉菜单的按钮上，用于指示下拉菜单的展开方向或状态。
void lv_dropdown_set_symbol(lv_obj_t * obj, const char * symbol);
//obj：指向下拉菜单对象的指针
//symbol：要显示的符号。可以是任何字符串，通常是一个字符或图标。如果设置为 NULL，则不显示符号。lv_dropdown_set_selected_highlight函数
用于设置下拉菜单（Dropdown）是否高亮显示当前选中项的函数。当用户打开下拉菜单时，此功能可以帮助用户更直观地看到当前选中的选项。
void lv_dropdown_set_selected_highlight(lv_obj_t * obj, bool en);
//obj：指向下拉菜单对象的指针
//en：布尔值，用于启用或禁用高亮显示功能
//true：启用高亮显示当前选中项
//false：禁用高亮显示当前选中项lv_dropdown_get_list函数
用于获取下拉菜单内部列表对象的函数。通过这个函数，可以直接访问和操作下拉菜单的列表部分，例如修改列表的样式、获取列表中的选项等。
lv_obj_t * lv_dropdown_get_list(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//ret:返回下拉菜单内部的列表对象指针（lv_obj_t *）。如果传入的对象不是有效的下拉菜单对象，则返回 NULL。lv_dropdown_get_text函数
用于获取下拉菜单（Dropdown）当前选中项文本的函数,在运行时动态地获取下拉菜单当前显示的文本内容
const char * lv_dropdown_get_text(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//返回当前选中项的文本内容。如果下拉菜单没有选中项或对象无效，则返回 NULLlv_dropdown_get_options函数
用于获取下拉菜单所有选项的函数。它返回一个字符串，其中包含所有选项，选项之间用换行符 \n 分隔
const char * lv_dropdown_get_options(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//ret:返回一个包含所有选项的字符串，选项之间用 \n 分隔。如果下拉菜单没有选项或对象无效，则返回 NULLlv_dropdown_get_selected函数
用于获取下拉菜单当前选中项索引的函数。它允许在运行时动态地获取用户选择的选项
uint16_t lv_dropdown_get_selected(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//返回当前选中项的索引，从 0 开始。如果下拉菜单没有选中项或对象无效，则返回 LV_DROPDOWN_OPTION_NONElv_dropdown_get_option_cnt函数
用于获取下拉菜单中选项数量的函数。它允许在运行时动态地查询下拉菜单中包含的选项总数。
uint16_t lv_dropdown_get_option_cnt(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//ret:返回下拉菜单中的选项数量。如果下拉菜单为空或对象无效，则返回 0lv_dropdown_get_selected_str函数
用于获取下拉菜单（Dropdown）当前选中项文本的函数。它将选中的选项名称复制到指定的缓冲区中
void lv_dropdown_get_selected_str(const lv_obj_t * obj, char * buf, uint32_t buf_size);
//obj：指向下拉菜单对象的指针
//buf：指向目标缓冲区的指针，用于存储选中的选项名称
//buf_size：目标缓冲区的大小，确保足够大以容纳选中的选项名称lv_dropdown_get_option_index函数
用于获取下拉菜单（Dropdown）中某个选项的索引的函数。它允许通过选项的文本内容来查找其在下拉菜单中的位置
int32_t lv_dropdown_get_option_index(const lv_obj_t * obj, const char * txt);
//obj：指向下拉菜单对象的指针
//txt：要查找的选项文本内容
//ret:返回选项的索引，从 0 开始。如果未找到匹配的选项文本，则返回 -1lv_dropdown_get_symbol函数
用于获取下拉菜单（Dropdown）当前设置的符号的函数
const char * lv_dropdown_get_symbol(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//ret:返回当前设置的符号字符串。如果没有设置符号，则返回 NULLlv_dropdown_get_selected_highlight函数
用于检查下拉菜单（Dropdown）是否启用了选中项高亮显示的函数
bool lv_dropdown_get_selected_highlight(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//ret:返回一个布尔值.true：启用了选中项的高亮显示.false：未启用选中项的高亮显示lv_dropdown_get_dir
用于获取下拉菜单（Dropdown）展开方向的函数
lv_dir_t lv_dropdown_get_dir(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//ret:返回下拉菜单的展开方向，类型为 lv_dir_t 枚举值
/*
LV_DIR_BOTTOM：向下展开（默认方向）。
LV_DIR_TOP：向上展开。
LV_DIR_LEFT：向左展开。
LV_DIR_RIGHT：向右展开
*/lv_dropdown_open
用于手动展开下拉菜单（Dropdown）的函数。通常情况下，下拉菜单会在用户点击时自动展开
void lv_dropdown_open(lv_obj_t * obj);
//obj：指向下拉菜单对象的指针lv_dropdown_close
voidlv_dropdown_close（lv_obj_t *obj)
//obj：指向下拉菜单对象的指针lv_dropdown_is_open
用于检查下拉菜单（Dropdown）是否处于展开状态的函数
bool lv_dropdown_is_open(const lv_obj_t * obj);
//obj：指向下拉菜单对象的指针
//reet:返回一个布尔值 true：下拉菜单处于展开状态false：下拉菜单处于关闭状态
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]