ESP32 开发笔记(四）LVGL控件学习 Label 文本标签控件

本文链接：https://blog.csdn.net/cnicfhnui/article/details/110677205

先看效果，创建三个不同的文本标签，文本内容可变颜色，文本过长动态滚动，带阴影3D效果

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

四、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_label):

标签是用于显示文本的基本对象类型。

零件和样式

标签只有一个主要部分，称为 LV_LABEL_PART_MAIN 。它使用所有典型的背景属性和文本属性。填充值可用于使文本的区域在相关方向上变小。

用法

设定文字

可以在运行时使用 lv_label_set_text(label, "New text") 在标签上设置文本。它将动态分配一个缓冲区，并将提供的字符串复制到该缓冲区中。因此，在该函数返回后，无需将传递给 lv_label_set_text 的文本保留在范围内。

使用 lv_label_set_text_fmt(label, "Value: %d", 15) ，可以使用printf格式设置文本。

标签能够显示来自0终止的静态字符缓冲区的文本。为此，请使用 lv_label_set_static_text(label, "Text") 。在这种情况下，文本不会存储在动态内存中，而是直接使用给定的缓冲区。这意味着数组不能是在函数退出时超出范围的局部变量。常数字符串可以安全地与 lv_label_set_static_text 一起使用（除非与 LV_LABEL_LONG_DOT 一起使用，因为它可以就地修改缓冲区），因为它们存储在ROM存储器中，该存储器始终可以访问。

也可以使用原始数组作为标签文本。数组不必以 \0 终止。在这种情况下，文本将与 lv_label_set_text 一样保存到动态存储器中。要设置原始字符数组，请使用 lv_label_set_array_text(label, char_array, size) 函数。

越线

换行符由标签对象自动处理。可以使用 \n 换行。例如： "line1\nline2\n\nline4"

长模式

默认情况下，标签对象的宽度会自动扩展为文本大小。否则，可以根据几种长模式策略来操纵文本：

LV_LABEL_LONG_EXPAND – 将对象大小扩展为文本大小（默认）
LV_LABEL_LONG_BREAK – 保持对象宽度，断开（换行）过长的线条并扩大对象高度
LV_LABEL_LONG_DOT – 保持对象大小，打断文本并在最后一行写点（使用 lv_label_set_static_text 时不支持）
LV_LABEL_LONG_SROLL – 保持大小并来回滚动标签
LV_LABEL_LONG_SROLL_CIRC – 保持大小并循环滚动标签
LV_LABEL_LONG_CROP – 保持大小并裁剪文本

可以使用 lv_label_set_long_mode(label, LV_LABEL_LONG_...) 指定长模式

重要的是要注意，当创建标签并设置其文本时，标签的大小已扩展为文本大小。除了默认的 LV_LABEL_LONG_EXPAND ，长模式 lv_obj_set_width/height/size() 无效。

因此，需要更改长模式，首先设置新的长模式，然后使用 lv_obj_set_width/height/size() 设置大小。

另一个重要的注意事项是 LV_LABEL_LONG_DOT 在原地操纵文本缓冲区，以便添加/删除点。当使用 lv_label_set_text 或lv_label_set_array_text 时，将分配一个单独的缓冲区，并且该实现细节不会被注意。 lv_label_set_static_text 并非如此！如果打算使用 LV_LABEL_LONG_DOT ，则传递给 lv_label_set_static_text 的缓冲区必须可写。