ESP32 开发笔记(四）LVGL控件学习 Keyboard 键盘控件

先看效果，创建两个输入框来演示键盘的调用，测试键盘不同模式输入方式，了解键盘的用法

开发板购买链接https://item.taobao.com/item.htm?spm=a2oq0.12575281.0.0.50111deb2Ij1As&ft=t&id=626366733674

一、开发板简介

二、开发环境搭建 windows

三、基础示例

四、LVGL控件使用示例

    LVGL_Arc_Test                                  圆弧指示器通过触摸动态改变值
    LVGL_Bar_Test                                  通过动画方式动态演示Bar进度条的使用方法
    LVGL_Button_Test                             通过5种不同动态效果的按钮学习按钮的创建与使用
    LVGL_ButtonMatrix_Test                   创建一个计算器布局来演示矩阵按钮控件的使用
    LVGL_Calendar_Test                         日历控件的创建和使用
   LVGL_Canvas_Test                          透明画布和画一个圆角过渡色矩形旋转角度学习画布的使用
    LVGL_Chart_Test                               通过创建三个不同风格的图表来学习图表控件的使用
    LVGL_Checkbox_Test                        学习复选框控件的创建和使用
    LVGL_ColorPicker_Test                     创建一个颜色选择器并动态显示当前颜色的RGB值
    LVGL_Container_Test                        在容器控件上动态创建三个文本标签
    LVGL_Drop_down_List_Test              创建三个不同类型的下拉选择控件
    LVGL_Gauge_Test                             创建一个动态仪表和静态多指针仪表
    LVGL_Image_Test                              通过四个滑动条控制图片颜色的变化学习图像控件的使用
    LVGL_ImageButton_Test                  创建一个图片背景的图像按钮
    LVGL_Keyboard_Test                       通过一个文本输入框控件还学习键盘控件的调用关闭设置
    LVGL_Label_Test                              创建颜色可变，长文本滚动，带阴影3D效果三个标签控件
    LVGL_LED_Test                                创建三个LED，学习LED控件的调光，颜色，开关的设置
    LVGL_Line_Test                                通过二维数组创建一段折线来演示线控件的使用
    LVGL_LineMeter_Test                      创建两个不同的线段弧形指示器动态展示数据
    LVGL_List_Test                                 创建一个带图标的列表控件
    LVGL_MessageBox_Test                  创建一个带按钮的消息框控件
    LVGL_ObjectMask_Test                    创建一个变幻色的文本学习蒙版遮罩效果
    LVGL_Page_Test                            学习页面控件的使用
    LVGL_Roller_Test                           通过示例学习滑动列表选择器控件
    LVGL_Slider_Test                           创建一个单向和一个双向滑动条控件
    LVGL_Spinbox_Test                        学习微调控件的使用
    LVGL_Spinner_Test                        创建三个不同的环形加载器
    LVGL_Switch_Test                          创建两个不同的开关控件
    LVGL_Table_Test                            创建一个简单的表格
    LVGL_Tabview_Test                       实现三页的页面切换学习Tabview控件
    LVGL_Textarea_Test                       长按实现打字机效果的Textarea控件
    LVGL_Tileview_Test                        实现四面环形触摸切换的Tileview控件
    LVGL_Window_Test                        创建一个窗口，带设置子窗口学习窗口控件的使用

键盘(lv_keyboard)：

Keyboard对象是特殊的 按钮矩阵(lv_imgbtn) ，具有预定义的按键映射和其他功能，以实现虚拟键盘来编写文本。

零件和样式

类似于按钮matices，键盘包括2部分：

• LV_KEYBOARD_PART_BG 这是主要部分，并使用了所有典型的背景属性
• LV_KEYBOARD_PART_BTN 这是按钮的虚拟部分。它还使用所有典型的背景属性和文本属性。

用法

模式

键盘具有以下模式：

• LV_KEYBOARD_MODE_TEXT_LOWER – 显示小写字母
• LV_KEYBOARD_MODE_TEXT_UPPER – 显示大写字母
• LV_KEYBOARD_MODE_TEXT_SPECIAL – 显示特殊字符
• LV_KEYBOARD_MODE_NUM – 显示数字，+ /-号和小数点。

文本模式( TEXT )的布局包含更改模式的按钮。

要手动设置模式，请使用 lv_keyboard_set_mode(kb, mode) 。默认更多是 LV_KEYBOARD_MODE_TEXT_UPPER 。

分配文本区域

可以为键盘分配一个 文本区域(Text area) ，以将单击的字符自动放在此处。要分配文本区域，请使用 lv_keyboard_set_textarea(kb, ta) 。

分配的文本区域的光标可以通过键盘进行管理：分配了键盘后，上一个文本区域的光标将被隐藏，并且将显示新的文本区域。当通过“确定”或“关闭”按钮关闭键盘时，光标也将被隐藏。游标管理器功能由 lv_keyboard_set_cursor_manage(kb, true) 启用。默认为不管理。

新的键盘布局

可以使用 lv_keyboard_set_map(kb, map) 和 lv_keyboard_set_ctrl_map(kb, ctrl_map) 为键盘指定新的地图（布局）。了解有关 按钮矩阵(lv_imgbtn) 的更多信息。记住，使用以下关键字将具有与原始地图相同的效果：

• LV_SYMBOL_OK – 应用.
• LV_SYMBOL_CLOSE – 关闭.
• LV_SYMBOL_BACKSPACE – 从左侧删除。
• LV_SYMBOL_LEFT – 向左移动光标。
• LV_SYMBOL_RIGHT – 向右移动光标。
• “ABC” – 加载大写地图。
• “abc” – 加载小写地图。
• “Enter” – 换行.

事件

除了 通用事件 ，键盘还支持以下 特殊事件 ：

• LV_EVENT_VALUE_CHANGED – 按下/释放按钮时发送，或长按后重复发送。事件数据设置为按下/释放按钮的ID。
• LV_EVENT_APPLY – OK按钮被点击
• LV_EVENT_CANCEL – 关闭按钮被点击

键盘具有一个默认的事件处理程序回调，称为lv_keyboard_def_event_cb。它处理按钮按下，地图更改，分配的文本区域等。可以将其完全替换为自定义事件处理程序，但是，可以在事件处理程序的开头调用lv_keyboard_def_event_cb来处理与以前相同的操作。

按键

键盘可处理一下以下按键：

• LV_KEY_RIGHT/UP/LEFT/RIGHT – 要在按钮之间导航并选择一个。
• LV_KEY_ENTER – 按下/释放所选按钮。