标签（label）组件的使用

VGL 标签的作用：

1. 显示信息：标签主要用于显示静态或动态的文字信息，如提示、标题、状态等。
2. 布局调整：可以设置标签的位置和对齐方式，使其适应不同的屏幕布局需求。
3. 动态更新：支持动态更改标签中的文本内容，比如实时数据显示。
4. 交互反馈：虽然标签本身通常不具备交互功能，但可以通过改变其内容或样式来响应用户的操作，提供视觉反馈。

多语言支持：可以结合多语言系统，在不同语言环境下显示相应的文字。

标签（lV_label）

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

在盒子模型里面，标签的组成包括：

LV_PART_MAIN矩形部分（盒子区域）。填充值可用于在文本和背景之间添加空间。

LV_PART_SCROLLBAR 当在展示的文本大于部件时，显示滚轮条部分。

LV_PART_SELECTED 选中文本时，突出显示部分。Label只能使用text_color和bg_color 样式属性。

创建标签：

Lv_obj_t * label = lv_label_create(parent);

设置显示文本：

创建了标签部件之后我们就可以设置文本来显示了。

直接设置要显示的文本:

lv_label _set _text(label, "New text");

格式化给定要显示的文本:

Iv _label set text fmt(label, “%s: %d", "Value". 15)

文本不存储在动态内存中，而是直接使用给定的缓冲区

iv label set text static(label. " New text"):

要在label换行非常简单，像printf函数那样使用\n 即可:

lv label set text(label." linel\nline2\n\nline4 "):

大小：

默认情况标签的大小会自动拓展成和文本一样的大小**(Iv_SIZE_CONTENT**)，:如果可以像前面课程说到的方法显式设置宽高:

lv_obj_set_size lvobj set width lv obi set height

这样就可能出现文本的宽度或高度大小label的情况，就需要做一些调整，下面是几种模式:

LV_LABEL_LONG_WRAP 如果有多个换行，并且如果高度为LV_SIZE_CONTENT，那么高度会根据文本换行被自动扩展;否则文本将被剪掉。(默认设置)

LV LABEL LONG DOT如果文本太长，就保持大小并在末尾写3个点

LV_LABEL_LONG_SCROLL 如果文本比标签宽(太长)，则可以水平来回滚动显示它。如果它很高(多个\n换行)，可以垂直滚动。只滚动一个方向，水平滚动的优先级更高。

LVL_LABEL_LONG_SCROLL_CIRCULAR 如果文本比标签宽，则水平滚动它。如果它更高，就垂直滚动。只滚动一个方向，水平滚动的优先级更高。

LV_LABEL_LONG_CLIP 剪掉超出标签范围外的文本部分,。

可以使用 iv_labelset_long_mode(label, LV_LABEL_LONG...) 指定模式。

注意:LVL_LABEL_LONG.DOT是直接操作文本缓冲区以添加/删除点。如果使用 iv_abeLsettext 和ivJabeLsettex_ímt它们会分配一个单独的缓冲区，不会出问题。但是如果使用 iabeLseutexustatic 时我们传递给它的缓冲区必须是可写的。

文本着色：

我们可以很方便地给我们的要显示的文本重新着色，可以通过样式来上色，例如：

Lv_style_set_text_color(&style_obj,lv_color_hex(0xf7b37b));

Lv_label_set_text(label1,”#0000ff Re-color# #ff00ff words# #ff0000 of a# label”);

也可以让文本某些部分重新着色，例如:

olv label set recolor(labell. true):

lv_label_set_text(label1.“#0000ff Re-color# #ff00ff words# #ff0000 of a# label);

文本选择：

如果在 w.confh 中打开了 I_BELTExT_SELECHON(默认开启)，就可以选择部分文本了。这个和我们在PC用鼠标选中文本类似，但是这个效果只能在文本框(lv_extarea)中实现。Label只能事先手动选择指定范围的文本:

Lv_label_set_text sel start(label. 0);

Iv_label_set text sel end(label. 6);

显示图标：

标签的API

1. 创建标签

• lv_label_create(lv_obj_t *parent): 创建一个新的标签对象并将其添加到指定的父容器中。

  • 参数 parent 是标签的父对象。

1. 设置和获取文本

   • lv_label_set_text(lv_label_t *label, const char *text): 设置标签的文本内容。

     • 参数 text 是要显示的字符串。

   • lv_label_get_text(const lv_label_t *label): 获取标签的文本内容。

     • 返回值是当前标签的文本。

2. 设置长文本模式

   • lv_label_set_long_mode(lv_label_t *label, lv_label_long_mode_t mode): 设置如何处理过长的文本。

     • 参数 mode 可以是 LV_LABEL_LONG_WRAP, LV_LABEL_LONG_CLIP, LV_LABEL_LONG_ELLIPSIS 或 LV_LABEL_LONG_SCROLL.

       • LV_LABEL_LONG_WRAP: 文本自动换行。

       • LV_LABEL_LONG_CLIP: 超出部分被裁剪。

       • LV_LABEL_LONG_ELLIPSIS: 超出部分用省略号表示。

       • LV_LABEL_LONG_SCROLL: 文本滚动显示。

3. 设置对齐方式

   • lv_label_set_align(lv_label_t *label, lv_label_align_t align): 设置文本的对齐方式。

     • 参数 align 可以是 LV_LABEL_ALIGN_LEFT, LV_LABEL_ALIGN_CENTER, LV_LABEL_ALIGN_RIGHT.

4. 设置多行文本

   • lv_label_set_text_multiline(lv_label_t *label, const char *text): 设置多行文本。

     • 参数 text 包含换行符 \n 以分隔多行。

5. 设置滚动

   • lv_label_set_scroll(lv_label_t *label, bool enable): 开启或关闭标签文本的滚动显示。

     • 参数 enable 如果为 true 则启用滚动；否则禁用。

   • lv_label_set_scroll_speed(lv_label_t *label, uint16_t speed): 设置滚动的速度。

     • 参数 speed 滚动速度，单位为像素/秒。

   • lv_label_set_scroll_period(lv_label_t *label, uint32_t period): 设置完成一次滚动所需的时间。

     • 参数 period 单位为毫秒。

### 样式和外观

1. 设置字体

   • lv_label_set_style_text_font(lv_label_t *label, const lv_font_t *font, lv_part_t part): 设置标签的字体。

     • 参数 font 是字体结构体指针。

     • 参数 part 表示样式应用于哪个部分。

2. 设置颜色

   • lv_label_set_style_text_color(lv_label_t *label, lv_color_t color, lv_part_t part): 设置标签文本的颜色。

     • 参数 color 是颜色值。

     • 参数 part 表示样式应用于哪个部分。

3. 设置背景颜色

   • lv_label_set_style_bg_color(lv_label_t *label, lv_color_t color, lv_part_t part): 设置标签背景颜色。

     • 参数 color 是颜色值。

     • 参数 part 表示样式应用于哪个部分。

4. 设置边框

   • lv_label_set_style_border_width(lv_label_t *label, lv_coord_t width, lv_part_t part): 设置标签的边框宽度。

     • 参数 width 边框宽度。

     • 参数 part 表示样式应用于哪个部分。

   • lv_label_set_style_border_color(lv_label_t *label, lv_color_t color, lv_part_t part): 设置标签的边框颜色。

     • 参数 color 边框颜色。

     • 参数 part 表示样式应用于哪个部分。

5. 设置圆角

   • lv_label_set_style_radius(lv_label_t *label, lv_coord_t radius, lv_part_t part): 设置标签的圆角半径。

     • 参数 radius 圆角半径。

     • 参数 part 表示样式应用于哪个部分。

6. 设置阴影

   • lv_label_set_style_shadow_width(lv_label_t *label, lv_coord_t width, lv_part_t part): 设置标签阴影的宽度。

     • 参数 width 阴影宽度。

     • 参数 part 表示样式应用于哪个部分。

   • lv_label_set_style_shadow_color(lv_label_t *label, lv_color_t color, lv_part_t part): 设置标签阴影的颜色。

     • 参数 color 阴影颜色。

     • 参数 part 表示样式应用于哪个部分。

### 布局和位置

1. 设置位置

   • lv_obj_set_pos(lv_label_t *label, lv_coord_t x, lv_coord_t y): 设置标签的位置。

     • 参数 x 和 y 分别是X轴和Y轴的坐标。

2. 设置尺寸

   • lv_obj_set_size(lv_label_t *label, lv_coord_t width, lv_coord_t height): 设置标签的尺寸。

     • 参数 width 和 height 分别是宽度和高度。

3. 设置自动重排

   • lv_obj_set_auto_realign(lv_label_t *label, bool enable): 设置是否自动调整标签尺寸以适应文本。

     • 参数 enable 如果为 true 则开启自动重排；否则关闭。

4. 设置最大宽度

   • lv_obj_set_width(lv_label_t *label, lv_coord_t width): 设置标签的最大宽度。

     • 参数 width 最大宽度。