页签(lv_tabview)页签对象可用于组织选项卡中的内容。
Tab视图对象包含几个部分。主要是 LV_TABVIEW_PART_BG
。它是一个矩形容器,用于容纳Tab视图的其他部分。
在背景上创建了2个重要的实际部分:
LV_TABVIEW_PART_BG_SCRL
这是 页面(lv_page) 的可滚动部分。它使选项卡的内容彼此相邻。页面的背景始终是透明的,不能从外部访问。LV_TABVIEW_PART_TAB_BG
选项卡按钮是一个 按钮矩阵(lv_btnmatrix) 。单击按钮将 LV_TABVIEW_PART_BG_SCRL
滚动到相关选项卡的内容。可以通过 LV_TABVIEW_PART_TAB_BTN
访问选项卡按钮。选择选项卡时,按钮处于选中状态,可以使用 LV_STATE_CHECKED
设置样式。选项卡的按钮矩阵的高度是根据字体高度加上背景和按钮样式的填充来计算的。列出的所有部分均支持典型的背景样式属性和填充。
LV_TABVIEW_PART_TAB_BG
还有一个实际部分,即一个指标,称为 LV_TABVIEW_PART_INDIC
。它是当前选定选项卡下的一个类似矩形的细对象。当选项卡视图是动画到其它选项卡中的指示器也将被动画。它可以是使用典型背景样式属性的样式。 size样式属性将设置其厚度。
添加新选项卡后,将在 LV_TABVIEW_PART_BG_SCRL
上为其创建一个页面,并将新按钮添加到 LV_TABVIEW_PART_TAB_BG
按钮矩阵。创建的页面可以用作普通页面,它们具有通常的页面部分。
可以使用 lv_tabview_add_tab(tabview, "Tab name")
添加新标签。它将返回指向可以创建选项卡内容的 页面(lv_page) 对象的指针。
通过下面的方法选中一标签:
lv_tabview_set_tab_act(tabview, id, LV_ANIM_ON/OFF)
函数要在运行时更改选项卡ID的名称(底层按钮矩阵的显示文本),可以使用函数 lv_tabview_set_tab_name(tabview, id, name)
。
默认情况下,选项卡选择器按钮位于“选项卡”视图的顶部。可以使用 lv_tabview_set_btns_pos(tabview, LV_TABVIEW_TAB_POS_TOP/BOTTOM/LEFT/RIGHT/NONE)
进行更改
LV_TABVIEW_TAB_POS_NONE
将隐藏选项卡。
请注意,添加标签后,您无法将标签的位置从顶部或底部更改为左侧或右侧。
动画时间由 lv_tabview_set_anim_time(tabview, anim_time_ms)
调整。加载新选项卡时使用。
由于选项卡的内容对象是一个Page,因此它可以从其他类似Page的对象接收滚动传播。 例如,如果在选项卡的内容上创建了一个文本区域,并且滚动了该文本区域,但到达末尾,则滚动可以传播到内容页面。可以使用lv_page_set_scroll_propagation(tab_page, false)
启用它。
默认情况下,选项卡的内容页面已启用滚动传播,因此,当它们水平滚动时,滚动内容将传播到 LV_TABVIEW_PART_BG_SCRL
,这样页面将被滚动。
可以使用 lv_page_set_scroll_propagation(tab_page, false)
禁用手动滑动。
除了 通用事件 ,页签还支持以下 特殊事件 :
了解有关 事件 的更多内容。
复选框可处理以下按键:
了解有关 按键 的更多内容。
上述效果的示例代码:
#include "../../../lv_examples.h"
#if LV_USE_TABVIEW
void lv_ex_tabview_1(void)
{
/*Create a Tab view object*/
lv_obj_t *tabview;
tabview = lv_tabview_create(lv_scr_act(), NULL);
/*Add 3 tabs (the tabs are page (lv_page) and can be scrolled*/
lv_obj_t *tab1 = lv_tabview_add_tab(tabview, "Tab 1");
lv_obj_t *tab2 = lv_tabview_add_tab(tabview, "Tab 2");
lv_obj_t *tab3 = lv_tabview_add_tab(tabview, "Tab 3");
/*Add content to the tabs*/
lv_obj_t * label = lv_label_create(tab1, NULL);
lv_label_set_text(label, "This the first tab\n\n"
"If the content\n"
"of a tab\n"
"become too long\n"
"the it \n"
"automatically\n"
"become\n"
"scrollable.");
label = lv_label_create(tab2, NULL);
lv_label_set_text(label, "Second tab");
label = lv_label_create(tab3, NULL);
lv_label_set_text(label, "Third tab");
}
#endif
本文链接:http://so.lmcjl.com/news/19778/