键盘(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_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 - 按下/释放所选按钮。
了解有关 按键 的更多内容。
范例¶
带文字区域的键盘¶
上述效果的示例代码:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 | #include "../../../lv_examples.h"
#if LV_USE_KEYBOARD
static lv_obj_t * kb;
static lv_obj_t * ta;
static void kb_event_cb(lv_obj_t * keyboard, lv_event_t e)
{
lv_keyboard_def_event_cb(kb, e);
if(e == LV_EVENT_CANCEL) {
lv_keyboard_set_textarea(kb, NULL);
lv_obj_del(kb);
kb = NULL;
}
}
static void kb_create(void)
{
kb = lv_keyboard_create(lv_scr_act(), NULL);
lv_keyboard_set_cursor_manage(kb, true);
lv_obj_set_event_cb(kb, kb_event_cb);
lv_keyboard_set_textarea(kb, ta);
}
static void ta_event_cb(lv_obj_t * ta_local, lv_event_t e)
{
if(e == LV_EVENT_CLICKED && kb == NULL) {
kb_create();
}
}
void lv_ex_keyboard_1(void)
{
/*Create a text area. The keyboard will write here*/
ta = lv_textarea_create(lv_scr_act(), NULL);
lv_obj_align(ta, NULL, LV_ALIGN_IN_TOP_MID, 0, LV_DPI / 16);
lv_obj_set_event_cb(ta, ta_event_cb);
lv_textarea_set_text(ta, "");
lv_coord_t max_h = LV_VER_RES / 2 - LV_DPI / 8;
if(lv_obj_get_height(ta) > max_h) lv_obj_set_height(ta, max_h);
kb_create();
}
#endif
|
相关API¶
TODO