可靠的MCU伙伴
Design for Reliability
全国服务咨询热线
0757-8185 9361

对象层级(Layers)


对象层级(Layers)

创建对象层级顺序

默认情况下,LVGL在背景上绘制旧对象,在前景上绘制新对象。

例如,假设我们向父对象添加了一个名为 button1 的按钮,然后又添加了另一个名为button2的按钮。 由于先创建了 button1,所以 button1 会被 button2 及其子对象覆盖。


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
    /*Create a screen*/
    lv_obj_t * scr = lv_obj_create(NULL, NULL);
    lv_scr_load(scr);                                                               /*Load the screen*/


    /*Create 2 buttons*/
    lv_obj_t * btn1 = lv_btn_create(scr, NULL);         /*Create a button on the screen*/
    lv_btn_set_fit(btn1, true, true);                   /*Enable to automatically set the size according to the content*/
    lv_obj_set_pos(btn1, 60, 40);                                   /*Set the position of the button*/


    lv_obj_t * btn2 = lv_btn_create(scr, btn1);         /*Copy the first button*/
    lv_obj_set_pos(btn2, 180, 80);                          /*Set the position of the button*/


    /*Add labels to the buttons*/
    lv_obj_t * label1 = lv_label_create(btn1, NULL);        /*Create a label on the first button*/
    lv_label_set_text(label1, "Button 1");                  /*Set the text of the label*/


    lv_obj_t * label2 = lv_label_create(btn2, NULL);        /*Create a label on the second button*/
    lv_label_set_text(label2, "Button 2");                  /*Set the text of the label*/


    /*Delete the second label*/
    lv_obj_del(label2);



将图层设到前台(foreground)展示

有几种方法可以将对象置于前台:

使用
lv_obj_set_top(objtrue)
。如果 obj 或它的任何子对象被点击,那么 LVGL 将自动将该对象带到前台。它的工作原理类似于PC机上典型的GUI,当点击背景中的窗口时,它会在前台展示。

使用lv_obj_move_foreground(obj) 显式地告诉库将对象带到前台。类似地,使用
lv_obj_move_background(obj)
将对象 obj 移动到背台。

当使用
lv_obj_set_parent(objnew_parent)
时, obj 将在
new_parent
的前面。

顶层和系统层

LVGL 有两个特殊的图层;
layer_top

layer_sys
。两者在显示器的所有屏幕上都是可见且通用的。
但是,它们不会在多个物理显示器之间共享。
layer_top
始终位于默认屏幕 (
lv_scr_act()
)
的顶部,
layer_sys
则位于
layer_top
的顶部。用户可以使用
layer_top
来创建一些随处可见的内容。例如,菜单栏,弹出窗口等。如果启用了
click
属性,那么
layer_top
将吸收所有用户单击并充当模态。


1
    lv_obj_set_click(lv_layer_top(), true);



layer_sys
也用于LVGL。例如,它将鼠标光标放在那里以确保它始终可见。

事件(Events)

LVGL中可触发事件,用于与用户进行交互。例如一个对应对象的事件可以有:

被点击

被拖拽

被更改了数值

等等

我们可以将回调函数分配给对象以处理这些事件。例如:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
lv_obj_t * btn = lv_btn_create(lv_scr_act(), NULL);
lv_obj_set_event_cb(btn, my_event_cb);      /* 指定一个事件回调函数 */


    ...


    static void my_event_cb(lv_obj_t * obj, lv_event_t event)
    {
            switch(event) {
                    case LV_EVENT_PRESSED:              /* 对象被按下 */
                            printf("Pressed\n");
                            break;


                    case LV_EVENT_SHORT_CLICKED:        /* 对象被点击 */
                            printf("Short clicked\n");
                            break;


                    case LV_EVENT_CLICKED:              /* 对象被短点击 */
                            printf("Clicked\n");
                            break;


                    case LV_EVENT_LONG_PRESSED:         /* 对象被长按 */
                            printf("Long press\n");
                            break;


                    case LV_EVENT_LONG_PRESSED_REPEAT:   /* 对象被重复长按 */
                            printf("Long press repeat\n");
                            break;


                    case LV_EVENT_RELEASED:             /* 对象被释放 */
                            printf("Released\n");
                            break;
            }


               /*Etc.*/
    }



注意:多个对象可以使用同一回调函数。

事件类型

事件类型有如下几种:

通用事件

所有对象(例如 Buttons/Labels/Sliders 等)都可以接收这些通用事件。

与输入设备有关的事件

当用户按下/释放对象时,将发送这些消息。它们不仅用于指针,还可以用于键盘,编码器和按钮输入设备。访问输入设备概述部分以了解有关它们的更多信息。

LV_EVENT_PRESSED
该对象被按下

LV_EVENT_PRESSING
按下对象(按下时连续发送)

LV_EVENT_PRESS_LOST
输入设备仍在按,但不再在对象上

LV_EVENT_SHORT_CLICKED

LV_INDEV_LONG_PRESS_TIME
时间之前发布。如果拖动则不调用。

LV_EVENT_LONG_PRESSED
按下
LV_INDEV_LONG_PRESS_TIME
时间。如果拖动则不调用。

LV_EVENT_LONG_PRESSED_REPEAT
在每
LV_INDEV_LONG_PRESS_REP_TIME
毫秒的
LV_INDEV_LONG_PRESS_TIME
之后调用。如果拖动则不调用。

LV_EVENT_CLICKED
如果未拖动则调用释放(无论长按)

LV_EVENT_RELEASED
在上面每种情况下都被调用,即使对象已被拖动也被释放。如果在按下并从对象外部释放时从对象上滑出,则不会调用。在这种情况下,将发送
LV_EVENT_PRESS_LOST

指针相关的事件

这些事件仅由类似指针的输入设备(例如鼠标或触摸板)触发

LV_EVENT_DRAG_BEGIN
开始拖动对象

LV_EVENT_DRAG_END
拖动完成(包括拖动)

LV_EVENT_DRAG_THROW_BEGIN
拖动开始(用动量拖动后释放)

与键盘和编码器相关的事件

这些事件由键盘和编码器输入设备发送。在 [overview/indev](输入设备)部分中了解有关组的更多信息。

LV_EVENT_KEY
键值发送到对象。通常在按下它或在长按之后重复时。可以通过以下方式检索键值
uint32_t
*
key
=
lv_event_get_data()

LV_EVENT_FOCUSED
该对象集中在其组中

LV_EVENT_DEFOCUSED
该对象在其组中散焦

一般事件

LVGL库发送的其他一般事件。

LV_EVENT_DELETE
该对象正在被删除。释放相关的用户分配数据。

特殊事件

这些事件特定于特定的对象类型。

LV_EVENT_VALUE_CHANGED
对象值已更改(例如,对于滑块)

LV_EVENT_INSERT
有内容插入到对象中。 (通常到文本区域)

LV_EVENT_APPLY
单击确定应用或类似的特定按钮。 (通常来自键盘对象)

LV_EVENT_CANCEL
单击关闭取消或类似的特定按钮。 (通常来自键盘对象)

LV_EVENT_REFRESH
查询以刷新对象。永远不会由库发送,但可以由用户发送。

请访问特定对象类型的文档,以了解对象类型使用了哪些事件。

自定义事件包含的数据

一些事件可能包含自定义数据。 例如,在某些情况下,
LV_EVENT_VALUE_CHANGED
会告知新值。有关更多信息,请参见特定对象类型的文档。 要在事件回调中获取自定义数据,请使用
lv_event_get_data()

自定义数据的类型取决于发送对象,但如果是下面两种情况需要特殊对待:

数值,则为 uint32_t * int32_t * 类型

字符,则为 char * const char * 类型

手动发送事件

任意事件

要将事件手动发送到对象,请使用
lv_event_send(obj,
LV_EVENT_...,
&
custom_data)

例如,它可以通过模拟按钮按下来手动关闭消息框(尽管有更简单的方法):


1
2
3
    /*Simulate the press of the first button (indexes start from zero)*/
    uint32_t btn_id = 0;
    lv_event_send(mbox, LV_EVENT_VALUE_CHANGED, &btn_id);



刷新事件

LV_EVENT_REFRESH
是特殊事件,因为它旨在供用户用来通知对象刷新自身。一些例子:

通知标签根据一个或多个变量(例如当前时间)刷新其文本

语言更改时刷新标签

如果满足某些条件,请启用按钮(例如,输入正确的PIN

如果超出限制,则向对象添加样式/从对象删除样式等

处理类似情况的最简单方法是利用以下函数:

lv_event_send_refresh(obj)
只是
lv_event_send(obj,
LV_EVENT_REFRESH,
NULL)

的包装。因此,它仅向对象发送
LV_EVENT_REFRESH

lv_event_send_refresh_recursive(obj)

LV_EVENT_REFRESH
事件发送给对象及其所有子对象。如果将
NULL
作为参数传递,则将刷新所有显示的所有对象。