LVGL组件设计之虚拟键盘

原创

已于 2025-02-27 09:06:30 修改 · 1.4k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#linux #物联网 #mcu

于 2025-02-24 23:48:24 首次发布

LVGL组件设计之虚拟键盘

1. 概述

虚拟键盘组件(virt_kb)是基于LVGL的键盘控件实现的一个通用输入组件，为触摸屏设备提供便捷的文本输入功能。该组件封装了LVGL原生键盘控件的常用功能，并提供了简单的接口用于管理键盘的显示、隐藏等操作。项目说明，详见《AM335x Linux平台LVGL演示项目源码说明》

2. 开发环境说明

2.1 开发环境

处理器：AM3354
显示屏：支持触摸功能的LCD屏幕
操作系统：Linux 3.2
LVGL版本：v8.3
构建工具：CMake 3.16+
交叉编译工具链：arm-arago-linux-gnueabi-gcc 4.5.3

2.2 依赖组件

LVGL核心库
触摸屏驱动（tslib）

2.2 源码路径

https://gitcode.com/am335xt3/lvgl/tree/main/apps/tests/virtboardTest

3. 核心功能

3.1 组件结构

虚拟键盘组件主要由以下部分组成：

typedef struct {
   
   
    lv_obj_t *kb;           /* LVGL键盘对象 */
    lv_obj_t *ta;           /* 当前关联的文本输入框 */
    bool is_visible;        /* 键盘是否可见 */
} virt_kb_t;

3.2 主要接口

组件提供以下核心接口：

virt_kb_init(): 初始化虚拟键盘
virt_kb_show(): 显示虚拟键盘
virt_kb_hide(): 隐藏虚拟键盘
virt_kb_destroy(): 销毁虚拟键盘

4. 实现细节

4.1 键盘初始化

键盘初始化过程包括：

创建键盘对象
设置键盘属性（模式、大小、对齐方式等）
配置键盘样式
注册事件回调

关键代码：

virt_kb_t *virt_kb_init(void)
{
   
   
    virt_kb_t *kb = (virt_kb_t *)malloc(sizeof(virt_kb_t));
    
    /* 创建键盘对象 */
    kb->kb = lv_keyboard_create(lv_scr_act());
    
    /* 设置键盘属性 */
    lv_keyboard_set_mode(kb->kb, LV_KEYBOARD_MODE_TEXT_LOWER);
    lv_obj_add_flag(kb->kb, LV_OBJ_FLAG_HIDDEN);
    
    /* 设置键盘样式 */
    lv_obj_set_size(kb->kb, LV_PCT(100), LV_PCT(50));
    lv_obj_align(kb->kb, LV_ALIGN_BOTTOM_MID, 0, 0