官方手册:Label (lv_label) — LVGL documentationhttps://docs.lvgl.io/master/widgets/core/label.html
标签(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, "HELLOW LVGL");
也能够显示来自静态字符缓冲区的文本。文本不会存储在动态内存中,而是直接使用给定的缓冲区。
lv_label_set_text_static(label, "Text")
格式化显示文本
lv_label_set_text_fmt(label, "Value: %d", 15)
换行
使用 \n 换行,例如:
lv_label_set_text(label, "line1\nline2\n\nline4");
设置文本大小
默认情况标签的大小设置为 LV_SIZE_CONTENT 会自动拓展成和文本一样的大小。
如果设置了宽度或高度,可以根据几种长模式策略来操纵比标签宽度更宽的文本。
lv_obj_set_width(label,50); //设置宽度
lv_obj_set_height(label,20); //设置高度
lv_obj_set_size(label,20,50);
这样就可能出现文本的宽度或高度大小label的情况,就需要做一些调整。
- LV_LABEL_LONG_WRAP:换行太长。 如果高度是 LV_SIZE_CONTENT标签的高度将被扩大,否则文本将被剪裁。 (默认)
- LV_LABEL_LONG_DOT:将标签右下角的最后 3 个字符替换为点 ( ...)
- LV_LABEL_LONG_SCROLL:如果文本比标签宽,则水平来回滚动。 如果它更高,请垂直滚动。 只滚动一个方向,水平滚动具有更高的优先级。
- LV_LABEL_LONG_SCROLL_CIRCULAR:如果文本比标签宽,则连续水平滚动。 如果它更高,请垂直滚动。 只滚动一个方向,水平滚动具有更高的优先级。
- LV_LABEL_LONG_CLIP:只需剪切标签外的文本部分即可
注意:LV_LABEL_LONG_DOT 是直接操作文本缓冲区以添加/删除点。如果使用 lv_label_set_text 和 lv_label_set_text_fmt 它们会分配一个单独的缓冲区,不会出问题。但是如果使用 lv_label_set_text_static 时我们传递给它的缓冲区必须是可写的。
设置接口
lv_label_set_long_mode(label, LV_LABEL_LONG_...)
设置字体样式
设置自定义字库也如同这样
lv_obj_t * label = lv_label_create(lv_scr_act()); // 创建一个label部件(对象),他的父对象是活动屏幕对象
lv_obj_set_style_text_font(label, &lv_font_simsun_16_cjk, 0); // 使用内置的 cjk 字库
lv_label_set_text(label, "text");
文本重新着色
改变标签颜色
lv_obj_set_style_bg_color(label, lv_color_hex(0xf7b37b), 0);
lv_obj_set_style_bg_opa(label, 100, 0); //不透明度
可以通过样式改色
lv_style_set_text_color(&style_obj, lv_color_hex(0xf7b37b)); //共享样式
lv_obj_set_style_text_color(label, lv_color_hex(0xf7b37b), 0); //本地样式
可以让文本某些部分重新上色
说明:#0000ff Re-color#:颜色值:0x0000ff,改变文本:Re-color
lv_label_set_recolor(label, true);
lv_label_set_text(label, "#0000ff Re-color# #ff00ff words# #ff0000 of a# label");
文本选择
如果在 lv_conf.h 中打开了 LV_LABEL_TEXT_SELECTION (默认开启),就可以选择部分文本了。这个和我们在PC用鼠标选中文本类似,但是这个效果只能在文本框(lv_textarea)中实现。Label只能事先手动选择指定范围的文本
lv_label_get_text_selection_start(label, start_char_index);
lv_label_get_text_selection_start(label, end_char_index);
lv_label_set_text_sel_start(label, 1);
lv_label_set_text_sel_end(label, 6);
内置图标
直接显示图标
lv_label_set_text(my_label, LV_SYMBOL_OK);
与字符串一起使用
lv_label_set_text(my_label, LV_SYMBOL_OK "Apply");
许多个图标一起
lv_label_set_text(my_label, LV_SYMBOL_OK LV_SYMBOL_WIFI LV_SYMBOL_PLAY);
事件
Label默认不接收输入事件,如果我们想设置输入类型的样式或者事件会无法生效,就需要打开 LV_OBJ_FLAG_CLICKABLE
lv_obj_add_flag(label, LV_OBJ_FLAG_CLICKABLE);
lv_obj_add_event_cb(label, function, LV_EVENT_ALL, 0);