【技术】在LVGL中用户界面的基本构建块之对象层级和事件的介绍

本文华芯微特将分享LVGL基础知识，创建对象层级顺序，事件(Events)使用方法，介绍了事件类型，详细说明了用户界面的基本构建块和对象层级和事件的介绍。

引言

在LVGL中，用户界面的基本构建块是对象，也称为小部件(widget)。默认情况下，LVGL在背景上绘制旧对象，在前景上绘制新对象。

对象层级(Layers)

创建对象层级顺序

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

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

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

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

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

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

•当使用 lv_obj_set_parent(obj，new_parent) 时， obj 将在 new_parent 的前面。

顶层和系统层

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

     lv_obj_set_click(lv_layer_top(), true);

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

事件(Events)

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

•被点击

•被拖拽

•被更改了数值

•等等

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

事件类型

事件类型有如下几种：

通用事件

所有对象（例如 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) 。

例如，它可以通过模拟按钮按下来手动关闭消息框（尽管有更简单的方法）：

  /*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 作为参数传递，则将刷新所有显示的所有对象。

以上就关于在LVGL中，用户界面的基本构建块之对象层级和事件的介绍。