下拉列表(lv_dropdown)¶
概述¶
下拉列表允许用户从列表中选择一个值。
下拉列表默认情况下处于关闭状态，并显示单个值或预定义的文本。激活后（通过单击下拉列表），将创建一个列表，用户可以从中选择一个选项。当用户选择新值时，该列表将被删除。
小部件和样式¶
调用下拉列表的主要部分， LV_DROPDOWN_PART_MAIN 它是一个简单的 lv_obj 对象。它使用所有典型的背景属性。按下，聚焦，编辑等阶梯也照常应用。
单击主对象时创建的列表是Page。它的背景部分可以被引用， LV_DROPDOWN_PART_LIST 并为矩形本身使用所有典型的背景属性，并为选项使用文本属性。要调整选项之间的间距，请使用text_line_space样式属性。填充值可用于在边缘上留出一些空间。
页面的可滚动部分被隐藏，其样式始终为空（透明，无填充）。
滚动条可以被引用 LV_DROPDOWN_PART_SCRLBAR 并使用所有典型的背景属性。
可以 LV_DROPDOWN_PART_SELECTED 使用所有典型的背景属性引用并使用所选的选项。它将以其默认状态在所选选项上绘制一个矩形，并在按下状态下在被按下的选项上绘制一个矩形。
用法¶
设定选项¶
选项作为带有 lv_dropdown_set_options(dropdown, options) 的字符串传递到下拉列表。选项应用 \n 分隔。例如： "First\nSecond\nThird" 。该字符串将保存在下拉列表中，因此也可以保存在本地变量中。
lv_dropdown_add_option(dropdown, "New option", pos) 函数向 pos 索引插入一个新选项。
为了节省内存，还可以使用 lv_dropdown_set_static_options(dropdown, options) 从静态（常量）字符串设置选项。在这种情况下，当存在下拉列表且不能使用 lv_dropdown_add_option 时，options字符串应处于活动状态
可以使用 lv_dropdown_set_selected(dropdown, id) 手动选择一个选项，其中id是选项的索引。
获取选择的选项¶
使用获取当前选择的选项 lv_dropdown_get_selected(dropdown) 。它将返回所选选项的索引。 lv_dropdown_get_selected_str(dropdown, buf, buf_size) 将所选选项的名称复制到 buf 。
方向¶
该列表可以在任何一侧创建。默认值 LV_DROPDOWN_DOWN 可以通过功能进行修改。 lv_dropdown_set_dir(dropdown, LV_DROPDOWN_DIR_LEFT/RIGHT/UP/DOWN)
如果列表垂直于屏幕之外，它将与边缘对齐。
符号¶
可以使用 lv_dropdown_set_symbol(dropdown, LV_SYMBOL_...) 将符号（通常是箭头）添加到下拉列表中
如果下拉列表的方向为 LV_DROPDOWN_DIR_LEFT ，则该符号将显示在左侧，否则显示在右侧。
最大高度¶
可以通过 lv_dropdown_set_max_height(dropdown, height) 设置下拉列表的最大高度。默认情况下，它设置为3/4垂直分辨率。
显示所选¶
主要部分可以显示所选选项或静态文本。可以使用 lv_dropdown_set_show_selected(sropdown, true/false) 进行控制。
可以使用 lv_dropdown_set_text(dropdown, "Text") 设置静态文本。仅保存文本指针。
如果也不想突出显示所选选项，则可以将自定义透明样式用于 LV_DROPDOWN_PART_SELECTED 。
动画时间¶
下拉列表的打开/关闭动画时间由 lv_dropdown_set_anim_time(ddlist, anim_time) 调整。动画时间为零表示没有动画。
手动打开/关闭¶
要手动打开或关闭下拉列表，可以使用 lv_dropdown_open/close(dropdown, LV_ANIM_ON/OFF) 功能。
按键¶
以下按键由按钮处理：
LV_KEY_RIGHT/DOWN - 选择下一个选项。
LV_KEY_LEFT/UP - 选择上一个选项。
LY_KEY_ENTER - 应用选定的选项（发送LV_EVENT_VALUE_CHANGED事件并关闭下拉列表）。
进一步了解 按键 。
范例¶
简单的下拉列表¶
简单的下拉列表¶
上述效果的示例代码：
1 #include "../../../lv_examples.h"
2 #include <stdio.h>
3 #if LV_USE_DROPDOWN
4
5
6 static void event_handler(lv_obj_t * obj, lv_event_t event)
7 {
8 if(event == LV_EVENT_VALUE_CHANGED) {
9 char buf[32];
10 lv_dropdown_get_selected_str(obj, buf, sizeof(buf));
11 printf("Option: %s\n", buf);
12 }
13 }
14
15 void lv_ex_dropdown_1(void)
16 {
17
18 /*Create a normal drop down list*/
19 lv_obj_t * ddlist = lv_dropdown_create(lv_scr_act(), NULL);
20 lv_dropdown_set_options(ddlist, "Apple\n"
21 "Banana\n"
22 "Orange\n"
23 "Melon\n"
24 "Grape\n"
25 "Raspberry");
26
27 lv_obj_align(ddlist, NULL, LV_ALIGN_IN_TOP_MID, 0, 20);
28 lv_obj_set_event_cb(ddlist, event_handler);
29 }
30
31 #endif
删除“上”列表¶
删除“上”列表¶
上述效果的示例代码：
1 #include "../../../lv_examples.h"
2 #include <stdio.h>
3 #if LV_USE_DROPDOWN
4
5
6 /**
7 * Create a drop LEFT menu
8 */
9 void lv_ex_dropdown_2(void)
10 {
11 /*Create a drop down list*/
12 lv_obj_t * ddlist = lv_dropdown_create(lv_scr_act(), NULL);
13 lv_dropdown_set_options(ddlist, "Apple\n"
14 "Banana\n"
15 "Orange\n"
16 "Melon\n"
17 "Grape\n"
18 "Raspberry");
19
20 lv_dropdown_set_dir(ddlist, LV_DROPDOWN_DIR_LEFT);
21 lv_dropdown_set_symbol(ddlist, NULL);
22 lv_dropdown_set_show_selected(ddlist, false);
23 lv_dropdown_set_text(ddlist, "Fruits");
24 /*It will be called automatically when the size changes*/
25 lv_obj_align(ddlist, NULL, LV_ALIGN_IN_TOP_RIGHT, 0, 20);
26
27 /*Copy the drop LEFT list*/
28 ddlist = lv_dropdown_create(lv_scr_act(), ddlist);
29 lv_obj_align(ddlist, NULL, LV_ALIGN_IN_TOP_RIGHT, 0, 100);
30 }
31
32 #endif
相关API¶
TODO