ESP32 开发笔记(四）LVGL控件学习 Tabview 标签视图控件

先看效果，创建一个带3个标签页面的标签视图控件

开发板购买链接https://item.taobao.com/item.htm?spm=a2oq0.12575281.0.0.50111deb2Ij1As&ft=t&id=626366733674

一、开发板简介

二、开发环境搭建 windows

三、基础示例

四、LVGL控件使用示例

    LVGL_Arc_Test                                  圆弧指示器通过触摸动态改变值
    LVGL_Bar_Test                                  通过动画方式动态演示Bar进度条的使用方法
    LVGL_Button_Test                             通过5种不同动态效果的按钮学习按钮的创建与使用
    LVGL_ButtonMatrix_Test                   创建一个计算器布局来演示矩阵按钮控件的使用
    LVGL_Calendar_Test                         日历控件的创建和使用
   LVGL_Canvas_Test                          透明画布和画一个圆角过渡色矩形旋转角度学习画布的使用
    LVGL_Chart_Test                               通过创建三个不同风格的图表来学习图表控件的使用
    LVGL_Checkbox_Test                        学习复选框控件的创建和使用
    LVGL_ColorPicker_Test                     创建一个颜色选择器并动态显示当前颜色的RGB值
    LVGL_Container_Test                        在容器控件上动态创建三个文本标签
    LVGL_Drop_down_List_Test              创建三个不同类型的下拉选择控件
    LVGL_Gauge_Test                             创建一个动态仪表和静态多指针仪表
    LVGL_Image_Test                              通过四个滑动条控制图片颜色的变化学习图像控件的使用
    LVGL_ImageButton_Test                  创建一个图片背景的图像按钮
    LVGL_Keyboard_Test                       通过一个文本输入框控件还学习键盘控件的调用关闭设置
    LVGL_Label_Test                              创建颜色可变，长文本滚动，带阴影3D效果三个标签控件
    LVGL_LED_Test                                创建三个LED，学习LED控件的调光，颜色，开关的设置
    LVGL_Line_Test                                通过二维数组创建一段折线来演示线控件的使用
    LVGL_LineMeter_Test                      创建两个不同的线段弧形指示器动态展示数据
    LVGL_List_Test                                 创建一个带图标的列表控件
    LVGL_MessageBox_Test                  创建一个带按钮的消息框控件
    LVGL_ObjectMask_Test                    创建一个变幻色的文本学习蒙版遮罩效果
    LVGL_Page_Test                            学习页面控件的使用
    LVGL_Roller_Test                           通过示例学习滑动列表选择器控件
    LVGL_Slider_Test                           创建一个单向和一个双向滑动条控件
    LVGL_Spinbox_Test                        学习微调控件的使用
    LVGL_Spinner_Test                        创建三个不同的环形加载器
    LVGL_Switch_Test                          创建两个不同的开关控件
    LVGL_Table_Test                            创建一个简单的表格
    LVGL_Tabview_Test                       实现三页的页面切换学习Tabview控件
    LVGL_Textarea_Test                       长按实现打字机效果的Textarea控件
    LVGL_Tileview_Test                        实现四面环形触摸切换的Tileview控件
    LVGL_Window_Test                        创建一个窗口，带设置子窗口学习窗口控件的使用

页签(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) 。

Tab按钮的位置

默认情况下，选项卡选择器按钮位于“选项卡”视图的顶部。可以使用 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) 禁用手动滑动。

事件

除了 通用事件 ，页签还支持以下 特殊事件 ：

• LV_EVENT_VALUE_CHANGED 通过滑动或单击选项卡按钮选择新选项卡时发送

按键处理

复选框可处理以下按键：

• LV_KEY_RIGHT/LEFT 选择一个标签
• LV_KEY_ENTER Change 更改为所选标签