|  **银杏科技有限公司旗下技术文档发布平台**  ||||
|技术支持电话|**0379-69926675-801**|||
|技术支持邮件|Gingko@vip.163.com|||
^  版本  ^  日期  ^  作者  ^  修改内容  ^
|  V1.0  |  2020-11-26  |  yang  |  初次建立  | 

===== 实验八：Events事件 =====

==== 一、事件简介 ====

在LVGL运行过程中，发生某些事情时会触发LVGL事件，例如某个对象
  * **被点击**
  * **被拖拽**
  * **其值已更改，等等**

用户可以给对象分配回调函数以查看这些事件，并作出相应的操作。下面就是一个按钮被按下时长不同触发不同事件的例子。

{{ :icore4t:icore4t_rtt_lvgl_8_1.gif?direct |}}

<code c>
static void my_event_cb(lv_obj_t * obj, lv_event_t event)
{
	switch(event) {
		case LV_EVENT_PRESSED:             /* 事件被按下 */
			lv_label_set_text(label, "Pressed");
			break;
		case LV_EVENT_SHORT_CLICKED:        /* 短点击 */
			lv_label_set_text(label, "Short clicked");
			break;
		case LV_EVENT_CLICKED:              /* 点击 */
			lv_label_set_text(label, "Clicked");
			break;
		case LV_EVENT_LONG_PRESSED:         /* 长按 */
			lv_label_set_text(label, "Long press");
			break;
		case LV_EVENT_LONG_PRESSED_REPEAT:  /* 重复长按 */
			lv_label_set_text(label, "Long press repeat");
			break;
		case LV_EVENT_RELEASED:             /* 释放 */
			lv_label_set_text(label, "Released");
			break;
 }
 }
void lv_gui_run(void)
{
	lvgl2rtt_init("lcd");                                 /* 初始化lvgl2rtt */

	lv_obj_t * btn1 = lv_btn_create(lv_scr_act(), NULL);  /* 创建按钮 */
	lv_obj_set_size(btn1, 200, 35);                       /* 设置尺寸 */
	lv_obj_set_event_cb(btn1, my_event_cb);               /* 回调函数 */
	lv_obj_align(btn1, NULL, LV_ALIGN_CENTER, 0, 0);      /* 居中对齐 */
	label = lv_label_create(btn1, NULL);                  /* 为按钮创建标签 */
	lv_label_set_text(label, "Released");                 /* 设置标签初始内容 */ 
}
</code>

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

==== 二、事件类型 ====

**2.1通用事件**

LVGL的所有对象（例如 Buttons / Labels / Sliders 等）都将接收这些通用事件，而不管它们的类型如何。

**2.2输入设备相关**

当用户按下/释放对象时发送这些消息。它们不仅用于按钮输入设备，还可以用于键盘，编码器和指针。该部分内容在输入设备章节会有详细介绍。
  * **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_TIME** 定义的时间后，每 **LV_INDEV_LONG_PRESS_REP_TIME** 毫秒触发一次，若对象被拖动则不触发。
  * **LV_EVENT_CLICKED** 对象被单击或长按后被释放，发送该事件，若对象被拖动则不触发。
  * **LV_EVENT_RELEASED** 当对象被释放时调用，即使它被拖动，但是在对象上按下然后从对象上滑出并在对象外部释放时，则不会调用。在这种情况下事件** LV_EVENT_PRESS_LOST** 被发送。

相关阈值定义，可以在 **lv_conf.h** 中找到并根据需求修改。
{{ :icore4t:icore4t_rtt_lvgl_8_2.png?direct |}}

**2.3指针相关**

这些事件仅由类似指针的输入设备（例如鼠标或触摸板）发送
  * **LV_EVENT_DRAG_BEGIN** 开始拖动对象。
  * **LV_EVENT_DRAG_END** 拖动完成（包括拖动）。
  * **LV_EVENT_DRAG_THROW_BEGIN** 开始拖动（释放后具有拖动“动量”）。

**2.4键盘和编码器相关**

下面这些事件由键盘和编码器输入设备发送。该部分内容在输入设备章节会有详细介绍。
  * **LV_EVENT_KEY** 对象发送一个键值，通常在按压后触发或长时间按压后重复触发。
  * **LV_EVENT_FOCUSED** 对象在其所在的组中获得焦点。
  * **LV_EVENT_DEFOCUSED** 对象在其所在的组中失去焦点。

**2.5一般事件**

库发送的其他一般事件。
  * **LV_EVENT_DELETE** 正在删除对象。释放相关的用户分配数据。

**2.6特别事件**

这些事件特定于特定的对象类型。
  * **LV_EVENT_VALUE_CHANGED** 对象值已更改（例如，对于Slider）。
  * **LV_EVENT_INSERT** 某物插入到对象中（通常插入到文本区域）。
  * **LV_EVENT_APPLY**  “Ok”,“Apply”这类的特定按钮被单击（通常来自键盘对象）。
  * **LV_EVENT_CANCEL** “Close”,“Cancel”这类的特定按钮被单击（通常来自键盘对象）。
  * **LV_EVENT_REFRESH** 查询以刷新对象。库不会发送，但用户可以发送。

==== 三、自定义数据 ====

一些事件可能包含自定义数据。例如，**LV_EVENT_VALUE_CHANGED** 在某些情况下会传递新值。要在事件回调中获取自定义数据，请使用 **lv_event_get_data()**。

自定义数据的类型取决于发送对象，例如

  * 数据是一个数，则类型为 uint32_t * 或者 int32_t *
  * 数据是文本内容，则类型为 char * 或者 const char *

==== 四、手动发送事件 ====

**4.1任意事件**

要将事件手动发送到对象，请使用 **lv_event_send(obj, LV_EVENT_..., &custom_data)**
例如，它可以通过模拟按钮按下来手动关闭消息框（尽管有更简单的方法）：
<code c>
/*模拟按下第一个按钮(索引从零开始)*/
uint32_t btn_id = 0;
lv_event_send(mbox, LV_EVENT_VALUE_CHANGED, &btn_id);
</code>

**4.2刷新事件**

**LV_EVENT_REFRESH** 是一个特殊事件，因为它旨在供用户用来通知对象刷新自身。下面是一些例子：
  * （1）通知标签根据一个或多个变量（例如当前时间）刷新其文本。
  * （2）语言更改时刷新标签。
  * （3）如果满足某些条件，则启用按钮（例如，输入正确的 PIN）。
  * （4）如果超出限制，则将样式添加到对象/从对象删除样式，等等。

处理类似情况的最简单方法是使用以下函数。函数 **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** 作为参数传递，则所有屏幕的所有对象都将刷新。