LVGL：拓展部件——键盘 lv_keyboard

这篇具有很好参考价值的文章主要介绍了LVGL：拓展部件——键盘 lv_keyboard。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

一、概述

此控件特点：

特殊Button矩阵：lv_keyboard 本质上是一个经过定制的按钮矩阵控件。每个按钮都可以独立触发事件或响应。
预定义的键映射：lv_keyboard 自带了一套预设的按键布局和对应的字符映射表，开发者可以根据需要选择或自定义这些键映射。
与 lv_textarea 配合使用：用户通过lv_keyboard 对象输入的文本会直接送入到 lv_textarea部件中显示。

二、包含组件元素

LV_PART_MAIN：背景部分。这部分通常定义了整个键盘区域的外观和视觉风格。
LV_PART_ITEMS：键盘上的各个按键元素。

三、相关函数

1、void lv_keyboard_set_textarea(lv_obj_t *kb, lv_obj_t *ta)

将一个 lv_textarea 对象与 lv_keyboard 对象关联起来。当在键盘上按下字符时，这些字符会被输入到指定的文本区域中。

2、void lv_keyboard_set_mode(lv_obj_t * obj, lv_keyboard_mode_t mode);

更改指定键盘对象的显示模式。

LV_KEYBOARD_MODE_TEXT_LOWER：小写字母键。
LV_KEYBOARD_MODE_TEXT_UPPER：大写字母键。
LV_KEYBOARD_MODE_SPECIAL：特殊字符键。
LV_KEYBOARD_MODE_NUMBER：数字、正负号（+/-）和小数点。
LV_KEYBOARD_MODE_USER_1 ~ LV_KEYBOARD_MODE_USER_4：用户自定义模式。

3、void lv_keyboard_set_map(lv_obj_t * obj, lv_keyboard_mode_t mode, const char * map[], const lv_btnmatrix_ctrl_t ctrl_map[])

更改键盘上显示的按键及其功能。

map: 指向一个字符串数组的指针，这个数组描述了新的按键布局。每个元素代表一个按键上的文本或符号。布局方式与 lv_btnmatrix_set_map() 函数中使用的类似，通常以数组形式存储一系列按键标签，比如字母、数字或特殊符号。

ctrl_map（可选）: 指向一个 lv_btnmatrix_ctrl_t 类型数组的指针，该数组用于描述特殊的控制按钮属性，如是否启用长按事件、是否是隐藏键等功能。这部分与 lv_btnmatrix_set_ctrl_map() 函数相似。

lv_obj_t *ta = lv_textarea_create(lv_scr_act());
lv_obj_t *kb = lv_keyboard_create(lv_scr_act());
lv_keyboard_set_textarea(kb, ta);

static const char * kb_map[] = {"1", "3", "5", "7", "A", "B", "C", LV_SYMBOL_BACKSPACE, "\n",
                                "2", "4", "6", "8", "E", "F", "G", LV_SYMBOL_NEW_LINE, "\n",
                                "+", "-", "*", "/", "0", "9", "\n",
                                LV_SYMBOL_CLOSE, "hello world", LV_SYMBOL_OK, NULL};

static const lv_btnmatrix_ctrl_t kb_ctrl[] = {0, LV_BTNMATRIX_CTRL_HIDDEN, 0, 0, 0, 0, 0, 0,
                                              0, 0, 0, 0, 0, 0, 0, 0,
                                              0, 0, 0, 0, 0, 0,
                                              0, 0, 0};

lv_keyboard_set_map(kb, LV_KEYBOARD_MODE_USER_1, kb_map, kb_ctrl);
lv_keyboard_set_mode(kb, LV_KEYBOARD_MODE_USER_1);

这里自定义了一个键盘布局，但是隐藏了第一排的第二个按键。