输入设备(Input devices)

在 LVGL 中输入设备，有下面几种类型：

  • 指针式输入设备，如触摸板或鼠标

  • 键盘，如普通键盘或简单的数字键盘

  • 带有左/右转向和推入选项的编码器

  • 外部硬件按钮，分配给屏幕上的特定点

在进一步阅读本文之前，请先阅读 输入设备接口 的部分内容

指针

指针输入设备可以具有光标。(通常是鼠标)

1    ...
2    lv_indev_t * mouse_indev = lv_indev_drv_register(&indev_drv);
3
4    LV_IMG_DECLARE(mouse_cursor_icon);                          /*Declare the image file.*/
5    lv_obj_t * cursor_obj =  lv_img_create(lv_scr_act(), NULL); /*Create an image object for the cursor */
6    lv_img_set_src(cursor_obj, &mouse_cursor_icon);             /*Set the image source*/
7    lv_indev_set_cursor(mouse_indev, cursor_obj);               /*Connect the image  object to the driver*/

请注意，光标对象应设置为 lv_obj_set_click(cursor_obj, false) 。对于图像，默认情况下禁用单击。

键盘和编码器

我们可以使用键盘或编码器完全控制用户界面，而无需触摸板或鼠标。它的作用类似于PC上的TAB键，可以在应用程序或网页中选择元素。

组

想要通过键盘或编码器控制的对象需要添加到Group中。在每个组中，只有一个集中的对象可以接收按下的键或编码器的动作。例如，如果将文本区域作为焦点，并且在键盘上按了某个字母，则将发送键并将其插入到文本区域中。同样，如果将滑块聚焦，然后按向左或向右箭头，则滑块的值将被更改。

需要将输入设备与组关联。一台输入设备只能将键发送到一组，但一组也可以从多个输入设备接收数据。

要创建组，请使用 lv_group_t * g = lv_group_create() ，然后将对象添加到组中，请使用 lv_group_add_obj(g, obj) 。

要将组与输入设备关联，请使用 lv_indev_set_group(indev, g) ，其中 indev 是 lv_indev_drv_register() 的返回值

按键

有一些预定义的键具有特殊含义：

  • LV_KEY_NEXT 专注于下一个对象

  • LV_KEY_PREV 专注于上一个对象

  • LV_KEY_ENTER 触发器 LV_EVENT_PRESSED/CLICKED/LONG_PRESSED 等事件

  • LV_KEY_UP 增加值或向上移动

  • LV_KEY_DOWN 减小值或向下移动

  • LV_KEY_RIGHT 增加值或向右移动

  • LV_KEY_LEFT 减小值或向左移动

  • LV_KEY_ESC 关闭或退出(例如，关闭下拉列表)

  • LV_KEY_DEL 删除(例如，“ 文本”区域中右侧的字符)

  • LV_KEY_BACKSPACE 删除左侧的字符(例如，在文本区域中)

  • LV_KEY_HOME 转到开头/顶部(例如，在“ 文本”区域中)

  • LV_KEY_END 转到末尾(例如，在“ 文本”区域中)

最重要的特殊键是 LV_KEY_NEXT/PREV ， LV_K​​EY_ENTER 和 LV_KEY_UP/DOWN/LEFT/RIGHT 。在 read_cb 函数中，应将某些键转换为这些特殊键，以便​​在组中导航并与所选对象进行交互。

通常，仅使用 LV_KEY_LEFT/RIGHT 就足够了，因为大多数对象都可以用它们完全控制。

对于编码器，应仅使用 LV_KEY_LEFT ， LV_K​​EY_RIGHT 和 LV_KEY_ENTER 。

编辑和浏览模式

由于键盘有很多键，因此很容易在对象之间导航并使用键盘进行编辑。但是，编码器的“键”数量有限，因此很难使用默认选项进行导航。创建导航和编辑是为了避免编码器出现此问题。

在导航模式下，编码器 LV_KEY_LEFT/RIGHT 转换为 LV_KEY_NEXT/PREV 。因此，将通过旋转编码器选择下一个或上一个对象。按 LV_KEY_ENTER 将更改为编辑模式。

在“ 编辑”模式下， LV_KEY_NEXT/PREV 通常用于编辑对象。根据对象的类型，短按或长按可将其 LV_KEY_ENTER 更改回导航模式。通常，无法按下的对象(如Slider)会在短按时离开“ 编辑”模式。但是，对于具有短单击含义的对象(例如Button)，需要长按。

样式

如果通过触摸板单击对象或通过编码器或键盘将其聚焦，则转到 LV_STATE_FOCUSED 。因此，将重点应用样式。

如果对象进入编辑模式，它将进入 LV_STATE_FOCUSED|LV_STATE_EDITED 状态，因此将显示这些样式属性。

相关API

TODO