【Qt实现虚拟键盘】

embedded/2024/11/17 14:47:55/

Qt实现虚拟键盘

  • 🌟项目分析
  • 🌟实现方式
  • 🌟开发流程

在这里插入图片描述

🌟项目分析

  • 需求:为Linux环境下提供可便捷使用的虚拟键盘
  • OS环境:Windows 7/11、CentOS 7
  • 开发语言:Qt/C++
  • IDE:QtCreator 、Qt5.14.2
  • 功能:支持中/英文/数字键盘输入、支持中文拼音输入法、支持半/全角标点输入

🌟实现方式

  • 方式一:调用第三方程序。windows下调用系统自带虚拟键盘。Linux下通过安装第三方虚拟键盘OnKeyboard,在程序中调用
    在这里插入图片描述

  • 方式二:使用Qt自带虚拟键盘。通过引入虚拟键盘模块,检测到程序内的输入控件焦点后,自动显示。
    在这里插入图片描述

  • 方式三:自定义虚拟键盘。设计虚拟键盘布局,实现键盘按键效果,接入谷歌中文拼音库。
    在这里插入图片描述
    本文接下来主要讲解方式三的实现。

🌟开发流程

  • 谷歌中文拼音库编译:
    1. 点击此处下载项目源码。
      在这里插入图片描述
    2. 打开QtCreator,导入该项目。在pinyinime.pro中添加下面命令CONFIG += staticlib。选择qmake并构建,在构建目录中可以看到,生成两个库文件:pinyinime.dll和pinyinime.lib,这两个库文件即为使用谷歌拼音库所需。
      在这里插入图片描述
  • 新建虚拟键盘项目:
    1. 创建QWidget项目。
      在这里插入图片描述
      2.选择构建套件。
      在这里插入图片描述
    2. 在项目路径下,创建文件夹lib、include、build、bin。拷贝生成的pinyinime.dll放入bin文件夹下,pinyinime.dll放入lib文件夹下。将pinyinime项目的src文件夹中所有文件拷贝到include文件夹中。
      在这里插入图片描述
    3. 修改VirtualKeyboard.pro文件,设置项目构建配置、可执行文件生成路径、第三方依赖引用、头文件引用。
QT       += core guigreaterThan(QT_MAJOR_VERSION, 4): QT += widgetsCONFIG += c++17
CONFIG -= debug_and_release# You can make your code fail to compile if it uses deprecated APIs.
# In order to do so, uncomment the following line.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0DESTDIR += $$PWD/binINCLUDEPATH += $$PWD/includeSOURCES += \main.cpp \keyboard.cppHEADERS += \keyboard.hFORMS += \keyboard.ui# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += targetwin32:CONFIG(release, debug|release): LIBS += -L$$PWD/lib/ -lpinyinime
else:win32:CONFIG(debug, debug|release): LIBS += -L$$PWD/lib/ -lpinyinimedINCLUDEPATH += $$PWD/include
DEPENDPATH += $$PWD/include
  • 虚拟键盘UI设计:

    1. 利用StackedWidget分别存放中/英文、数字、符号所对应的界面。
    2. 留出一个布局控件,用于存放候选词显示控件。
    3. 候选词数量级较小,通过使用QListWidget横向展示即可实现需求。
    4. 自定义标题栏,为了方便后期更换样式,适应使用场景。下面展示三种方式的键盘布局。
      在这里插入图片描述
      在这里插入图片描述
      在这里插入图片描述
  • 候选词类设计:

    1. 继承QListWidget,重写接口和信号。
    2. 集成对于谷歌拼音库的调用。
  • 下面是关键代码展示:

//调用谷歌拼音库搜索,获取候选词
QList<QString> CandidateWidget::search(const QString &pinyinPrefix)
{QList<QString> candidateList;// 1. 转换拼音前缀为小写QString normalizedPrefix = pinyinPrefix.toLower();// 重置搜索im_reset_search();// 4. 搜索拼音对应的汉字候选QByteArray bytearray(normalizedPrefix.toUtf8());char *pinyin(bytearray.data());size_t cand_num = im_search(pinyin, bytearray.size());// 5. 获取候选词char16 *cand_buf = new char16[max_decoded_length];for (size_t i = 0; i < cand_num; i++){char16 *cand = im_get_candidate(i, cand_buf, max_decoded_length);if (cand){QString candidateStr = QString::fromUtf16(cand);if (i == 0) candidateStr.remove(0, im_get_fixed_len()); // 去除固定拼音部分candidateList.append(candidateStr); // 加入候选词列表}}// 6. 释放资源delete[] cand_buf;// 7. 返回候选词列表return candidateList;
}
  • 项目主体类设计:
  1. 考虑到对于内存的管理以及场景的评估,这里将其封装成了单例工具类,方便在项目中使用。
  2. 实现候选词模块的嵌入。
  3. 实现UI中按键的响应函数,以及不同键盘布局之间的跳转。
  4. 处理焦点变化,实现实时检测焦点,可以动态更换交互控件。(需要在主应用中重写事件过滤器,检测焦点进入事件。并区分使用交互控件,发出全局焦点变化信号

展示关键部分代码:

//单例类的实现方式:
//Keyboard.h
public:// 获取单例实例static Keyboard *getInstance(QWidget *parent = nullptr);// 销毁单例实例static void destroyInstance();
private://声明静态实例static Keyboard* m_instance;//存放候选词ListWidgetCandidateWidget *m_pChineseWidget;  //Keyboard.cpp
// 定义静态实例
Keyboard* Keyboard::m_instance = nullptr;
// 获取单例实例
Keyboard* Keyboard::getInstance(QWidget *parent)
{if (m_instance == nullptr) {m_instance = new Keyboard(parent);}return m_instance;
}void Keyboard::destroyInstance()
{if (m_instance != nullptr){delete m_instance;m_instance = nullptr;}
}void initWidget(){....m_pChineseWidget = new CandidateWidget;m_pChineseWidget->setSizePolicy(QSizePolicy::Ignored, QSizePolicy::Ignored);ui->horizontalLayout_Chinese->addWidget(m_pChineseWidget);//嵌入候选词显示列表...connect(GlobalSignalManager::getInstance(),&GlobalSignalManager::focusChanged,this,&Keyboard::onFocusReceived,Qt::UniqueConnection);//绑定全局的焦点变化信号和焦点处理函数}void Keyboard::onFocusReceived(QWidget* newWidget,int type) {//我的主应用中有5中类型的交互控件,需要分别处理if (newWidget && m_currentTarget!=newWidget ) {if(m_currentTarget){disconnect(this,nullptr,m_currentTarget,nullptr);}// 保存当前聚焦控件LogDebug << "receive new WIDGET"<<newWidget->objectName();m_currentTarget = newWidget;switch (type) {case 0:{connect(this,&Keyboard::operateText,dynamic_cast<CustomLineEdit*>(m_currentTarget),&CustomLineEdit::operateTextSlot);break;}case 1:{connect(this,&Keyboard::operateText,dynamic_cast<CustomPlainTextEdit*>(m_currentTarget),&CustomPlainTextEdit::operateTextSlot);break;}case 2:{connect(this,&Keyboard::operateText,dynamic_cast<QLineEdit*>(m_currentTarget),[=](QString opt,QString text){
//                static QElapsedTimer timer;
//                if (timer.elapsed() < 100) {
//                    return;  // 节流机制:忽略100毫秒内的多次输入
//                }
//                timer.restart();if(opt == "insert"){dynamic_cast<QLineEdit*>(m_currentTarget)->insert(text);}else if(opt == "backspace"){if(!dynamic_cast<QLineEdit*>(m_currentTarget)->text().isEmpty()){dynamic_cast<QLineEdit*>(m_currentTarget)->backspace();}}});break;}case 3:{connect(this,&Keyboard::operateText,dynamic_cast<QPlainTextEdit*>(m_currentTarget),[=](QString opt,QString text){
//                static QElapsedTimer timer;
//                if (timer.elapsed() < 100) {
//                    return;  // 节流机制:忽略100毫秒内的多次输入
//                }
//                timer.restart();if(opt == "insert"){dynamic_cast<QPlainTextEdit*>(m_currentTarget)->insertPlainText(text);}else if(opt == "backspace"){if(!dynamic_cast<QPlainTextEdit*>(m_currentTarget)->toPlainText().isEmpty()){dynamic_cast<QPlainTextEdit*>(m_currentTarget)->undo();}} else if(opt == "enter"){dynamic_cast<QPlainTextEdit*>(m_currentTarget)->insertPlainText("\n");}});break;}case 4:{connect(this,&Keyboard::operateText,dynamic_cast<QTextEdit*>(m_currentTarget),[=](QString opt,QString text){
//                static QElapsedTimer timer;
//                if (timer.elapsed() < 100) {
//                    return;  // 节流机制:忽略100毫秒内的多次输入
//                }
//                timer.restart();if(opt == "insert"){dynamic_cast<QTextEdit*>(m_currentTarget)->insertPlainText(text);} else if(opt == "backspace"){if(!dynamic_cast<QTextEdit*>(m_currentTarget)->toPlainText().isEmpty()){dynamic_cast<QTextEdit*>(m_currentTarget)->undo();}} else if(opt == "enter"){dynamic_cast<QTextEdit*>(m_currentTarget)->insertPlainText("\n");}});break;}default:break;}}//MianWindow.cpp
//主程序的事件过滤
bool MainWindow::eventFilter(QObject *obj, QEvent *event)
{if (event->type() == QEvent::FocusIn) {if (dynamic_cast<CustomLineEdit*>(obj)) {LogDebug << obj->objectName() << " gained focus.";// 这里可以处理焦点事件emit GlobalSignalManager::getInstance()->focusChanged(qobject_cast<QWidget*>(obj),0);}else if(dynamic_cast<CustomPlainTextEdit*>(obj)){LogDebug << obj->objectName() << " gained focus.";emit GlobalSignalManager::getInstance()->focusChanged(qobject_cast<QWidget*>(obj),1);}else if(dynamic_cast<QLineEdit*>(obj)){LogDebug << obj->objectName() << " gained focus.";emit GlobalSignalManager::getInstance()->focusChanged(qobject_cast<QWidget*>(obj),2);}else if(dynamic_cast<QPlainTextEdit*>(obj)){LogDebug << obj->objectName() << " gained focus.";emit GlobalSignalManager::getInstance()->focusChanged(qobject_cast<QWidget*>(obj),3);}else if(dynamic_cast<QTextEdit*>(obj)){LogDebug << obj->objectName() << " gained focus.";emit GlobalSignalManager::getInstance()->focusChanged(qobject_cast<QWidget*>(obj),4);}} else if (event->type() == QEvent::FocusOut) {if (dynamic_cast<CustomLineEdit*>(obj)) {
//            LogDebug << obj->objectName() << "lost focus.";}}return QWidget::eventFilter(obj, event); // 确保事件传递给基类
}
}

🌟PinYinIMe接口描述

  1. 启动解码引擎
bool im_open_decoder(const char *fn_sys_dict, const char *fn_usr_dict);
  • fn_sys_dict: 系统字典,可以直接使用谷歌自带的字典dict_pinyin.dat
  • fn_usr_dict: 用户字典,用户自己定义的字典
    成功启动引擎时接口返回true。
bool im_open_decoder_fd(int sys_fd, long start_offset, long length,const char *fn_usr_dict);

上一个函数的变形。

  • sys_fd: 系统字典的文件描述符
  • start_offset: 系统字典文件描述符的偏移位置
  • length: 系统字典文件读取的长度
  • fn_usr_dict: 用户字典
  1. 关闭解码引擎
void im_close_decoder();
  1. 设置输入输出上限
void im_set_max_lens(size_t max_sps_len, size_t max_hzs_len);

如果本函数未被调用,则使用默认参数。举例说明该函数的作用,对于显示屏幕大小受限制,
显示部件可以只显示确定数量的输入字母来解码, 以及确定数量的中文来显示。
如果用户添加一个新字母之母, 输入的所有字母或输出的中文数量超过了设置的上限, 则引擎会不理踩
新添加的字母。

  • max_sps_len: 输入拼音字母的最大长度
  • max_hzs_len: 解码中文字符的最大长度
  1. 清除缓冲
void im_flush_cache();

因为引擎在运行时,为是达到最好的性能,一些数据有保存至内存中,所以有必要时需要清除掉。

  1. 搜索
size_t im_search(const char* sps_buf, size_t sps_len);

本函数用于搜索匹配字母的候选中文。当要搜索的字母的前缀与先前的搜索字母一样,引擎默认会在先前的
搜索结果中进行搜索。如果用户需要开启新的搜索,可以先调用im_reset_search()接口。

  • sps_buf: 拼音字母
  • sps_len: 字母长度
  • 返回候选数
  1. 删除
size_t im_delsearch(size_t pos, bool is_pos_in_splid, bool clear_fixed_this_step);

对当前查找结果执行删除操作, 然后再重新查找。

  • pos: 拼音字母的位置或者是搜索结果ID
  • is_pos_in_splid: 申明pos参数是字母位置还是搜索结果ID
  • clear_fixed_this_step:
  • 返回候选数量
  1. 初始化查找结果
void im_reset_search();
  1. 获取输入的拼音字母
const char *im_get_sps_str(size_t *decoded_len);
  • decoded_len: 保存返回拼音字母的长度arsed.
  • 返回拼音字母
  1. 获取候选字符串
char16* im_get_candidate(size_t cand_id, char16* cand_str, size_t max_len);
  • cand_id: 获取候选字符串的ID号,从0开始,通常ID为0是匹配度最高的
  • cand_str: 用于保存选择字符串的缓冲区
  • max_len: 缓冲区最大长度
  • 成功返回缓冲区地址cand_str,失败返回NULL.

🌟项目展示
在这里插入图片描述
在这里插入图片描述
如果有兴趣,下载源码,并尝试优化 :)
在这里插入图片描述


http://www.ppmy.cn/embedded/138277.html

相关文章

HarmonyOS4+NEXT星河版入门与项目实战--------开发工具与环境准备

文章目录 1、熟悉鸿蒙官网1、打开官网2、下载 DevEco Studio3、HarmonyOS 资源库4、开发指南与API 2、安装 DevEco Studio1、软件安装2、配置开发工具 1、熟悉鸿蒙官网 1、打开官网 百度搜索 鸿蒙开发者官网 点击进入开发者官网&#xff0c;点击开发&#xff0c;可以看到各种…

Postman接口测试(断言、关联、参数化、输出测试报告)

基本界面展示 Get、Post请求 Postman断言 使用postman来判断预期结果与实际结果是否一致 响应状态码断言 响应包含字符串 断言判断字符串的格式 关联 用于解决http请求之间存在依赖关系 依赖&#xff1a;一个http请求的响应结果中的数据&#xff0c;被另一个请求使用 登…

【数据结构】10.线索二叉树

一、线索二叉树的产生 采用先序、中序、后序三种方法遍历二叉树后都可以得到一个线性序列&#xff0c;序列上的每一个结点&#xff08;除了第一个和最后一个&#xff09;都有一个前驱和一个后继&#xff0c;但是&#xff0c;这个线性序列只是逻辑的概念&#xff0c;不是物理结…

深度学习在边缘检测中的应用及代码分析

摘要&#xff1a; 本文深入探讨了深度学习在边缘检测领域的应用。首先介绍了边缘检测的基本概念和传统方法的局限性&#xff0c;然后详细阐述了基于深度学习的边缘检测模型&#xff0c;包括其网络结构、训练方法和优势。文中分析了不同的深度学习架构在边缘检测中的性能表现&am…

ESP32C3单片机使用笔记---烧录MicroPython

使用MicroPython在ESP32C3单片机上编程&#xff0c;首先需要将MicroPython运行环境烧录到ESP32C3的Flash中去&#xff0c;步骤如下&#xff1a; 1.下载esptool烧录工具&#xff0c;下载地址&#xff1a; https://github.com/espressif/esptool 直接使用git clone git clone…

MongoDB自定义顺序排序

自定义顺序排序方法 以下是在MongoDB中实现自定义顺序排序的方法&#xff1a; 在数据集中添加一个自定义字段。使用update命令或$set操作符为每个文档添加自定义字段。在我们的例子中&#xff0c;我们可以通过以下命令为每个学生添加”grade”字段&#xff1a; db.students.…

androidstudio入门到放弃配置

b站视频讲解传送门 android_studio安装包&#xff1a;https://developer.android.google.cn/studio?hlzh-cn 下载安装 开始创建hello-world 1.删除缓存 文件 下载gradle文件压缩&#xff1a;gradle-8.9用自己创建项目时自动生成的版本即可&#xff0c;不用和我一样 https://…

<websocket><PLC>使用js和html实现webscoket,与PLC进行socket通讯的实例

前言 本文是为了实现从网页端通过websocket与PLC端的socket进行数据通讯。 环境配置 系统:windows 平台:visual studio code 语言:javascript、html、PLC 库:node.js 概述 本文的目的是通过网页端与PLC进行socket通讯,但web端一般并不是直接使用socket,而是websocket,…