@TOC

前言

在LVGL 9版本中，引入了一些强大的新功能，其中包括Flags标识和Group组。这两个概念为LVGL用户提供了更灵活、更高效的图形界面开发工具。Flags标识允许开发者更细致地控制小部件的状态和行为，而Group组则为管理和组织小部件提供了便捷的方式。本文将深入探讨这两个新特性，介绍它们的用法和优势，帮助读者更好地利用LVGL 9进行图形界面开发。

一、Flags

1.1 Flags是什么？

可以让部件处于某种状态，比如点击状态…

1.2 设置和移除某种状态

lv_obj_add/remove_flag(obj, LV_OBJ_FLAG_...)//添加/移除某个状态，参数2为要移除的状态
lv_obj_set_flag(obj, LV_OBJ_FLAG_..., true/false)//添加/移除某个状态，参数3 true为添加，false为移除

我们可以使用上面三个函数进行Flags的添加或者移除

1.3 状态列表

LV_OBJ_FLAG_HIDDEN： 使对象隐藏（就像它根本不存在一样）。
LV_OBJ_FLAG_CLICKABLE： 使对象可通过输入设备点击。
LV_OBJ_FLAG_CLICK_FOCUSABLE： 当被点击时，为对象添加焦点状态。
LV_OBJ_FLAG_CHECKABLE： 当对象被点击时切换选中状态。
LV_OBJ_FLAG_SCROLLABLE： 使对象可滚动。
LV_OBJ_FLAG_SCROLL_ELASTIC： 允许在内部滚动，但速度较慢。
LV_OBJ_FLAG_SCROLL_MOMENTUM： 当"抛出"时，使对象进一步滚动。
LV_OBJ_FLAG_SCROLL_ONE： 仅允许滚动一个可捕捉的子对象。
LV_OBJ_FLAG_SCROLL_CHAIN_HOR： 允许水平滚动传递给父对象。
LV_OBJ_FLAG_SCROLL_CHAIN_VER： 允许垂直滚动传递给父对象。
LV_OBJ_FLAG_SCROLL_CHAIN： (LV_OBJ_FLAG_SCROLL_CHAIN_HOR | LV_OBJ_FLAG_SCROLL_CHAIN_VER) 的简单组合。
LV_OBJ_FLAG_SCROLL_ON_FOCUS： 当聚焦时，自动滚动对象以使其可见。
LV_OBJ_FLAG_SCROLL_WITH_ARROW： 允许使用箭头键滚动聚焦对象。
LV_OBJ_FLAG_SNAPPABLE： 如果父对象启用了滚动捕捉，可以捕捉到该对象。
LV_OBJ_FLAG_PRESS_LOCK： 即使按压从对象滑动，也保持对象按下状态。
LV_OBJ_FLAG_EVENT_BUBBLE： 事件冒泡，将事件传播到父对象。
LV_OBJ_FLAG_GESTURE_BUBBLE： 手势冒泡，将手势传播到父对象。
LV_OBJ_FLAG_ADV_HITTEST： 允许执行更准确的点击测试，例如考虑到圆角。
LV_OBJ_FLAG_IGNORE_LAYOUT： 使对象可以被布局定位。
LV_OBJ_FLAG_FLOATING： 当父对象滚动时不滚动该对象，忽略布局。
LV_OBJ_FLAG_SEND_DRAW_TASK_EVENTS： 启用发送 LV_EVENT_DRAW_TASK_ADDED 事件。
LV_OBJ_FLAG_OVERFLOW_VISIBLE： 不裁剪子对象的内容到父对象的边界。
LV_OBJ_FLAG_FLEX_IN_NEW_TRACK： 在此项目上启动一个新的 flex 跟踪。
LV_OBJ_FLAG_LAYOUT_1： 自定义标志，布局可自由使用。
LV_OBJ_FLAG_LAYOUT_2： 自定义标志，布局可自由使用。
LV_OBJ_FLAG_WIDGET_1： 自定义标志，小部件可自由使用。
LV_OBJ_FLAG_WIDGET_2： 自定义标志，小部件可自由使用。
LV_OBJ_FLAG_USER_1： 自定义标志，用户可自由使用。
LV_OBJ_FLAG_USER_2： 自定义标志，用户可自由使用。
LV_OBJ_FLAG_USER_3： 自定义标志，用户可自由使用。
LV_OBJ_FLAG_USER_4： 自定义标志，用户可自由使用。

示例代码：

/*Hide on object*/
lv_obj_add_flag(obj, LV_OBJ_FLAG_HIDDEN);

/*Make an object non-clickable*/
lv_obj_remove_flag(obj, LV_OBJ_FLAG_CLICKABLE);

然后这个obj就被隐藏了，而且不能被点击

二、手势事件

手势方向其实就是滑动的方向

指针输入设备可以检测基本手势。默认情况下，大多数小部件将手势发送到其父级，因此最终手势可以以 LV_EVENT_GESTURE 事件的形式在屏幕对象上被检测到。

我们可以使用:lv_indev_get_gesture_dir(lv_indev_t)这个函数得到手势的方向，他返回一个lv_dir_t类型
他是这样定义的：

enum _lv_dir_t {
    LV_DIR_NONE     = 0x00,
    LV_DIR_LEFT     = (1 << 0),
    LV_DIR_RIGHT    = (1 << 1),
    LV_DIR_TOP      = (1 << 2),
    LV_DIR_BOTTOM   = (1 << 3),
    LV_DIR_HOR      = LV_DIR_LEFT | LV_DIR_RIGHT,
    LV_DIR_VER      = LV_DIR_TOP | LV_DIR_BOTTOM,
    LV_DIR_ALL      = LV_DIR_HOR | LV_DIR_VER,
};

里面包含着具体的方向

示例代码：

void my_event(lv_event_t * e)
{
  lv_obj_t * screen = lv_event_get_current_target(e);
  lv_dir_t dir = lv_indev_get_gesture_dir(lv_indev_active());
  switch(dir) {
    case LV_DIR_LEFT:
      ...
      break;
    case LV_DIR_RIGHT:
      ...
      break;
    case LV_DIR_TOP:
      ...
      break;
    case LV_DIR_BOTTOM:
      ...
      break;
  }
}

...

lv_obj_add_event_cb(screen1, my_event, LV_EVENT_GESTURE, NULL);

为了防止从对象传递手势事件给父级，请使用 lv_obj_remove_flag(obj, LV_OBJ_FLAG_GESTURE_BUBBLE)。

请注意，如果对象正在滚动，手势将不会触发。

如果您在手势上执行了某些操作，您可以在事件处理程序中调用 lv_indev_wait_release(lv_indev_active())以防止 LVGL 发送进一步的输入设备相关事件。

总结

Flags标识和Group组的引入为LVGL带来了新的可能性和便利性。Flags标识让开发者能够以更精细的粒度控制小部件的状态和行为，提升了界面的交互性和可定制性。同时，Group组的加入使得小部件的组织和管理变得更加简单而有序。通过这两个新特性，LVGL 9版本在提升开发者体验和提高开发效率方面迈出了重要的一步。在未来的LVGL应用程序中，Flags标识和Group组将成为开发者们更加依赖的工具，为构建出色的图形用户界面提供强大支持。