一、前言
在嵌入式板子上由于没有系统层面的输入法支持,所以都绕不开一个问题,那就是在需要输入的UI软件中,必须提供一个输入法来进行输入,大概从Qt5.7开始官方提供了输入法的源码,作为插件的形式加入到Qt中,这里需要特别提示的是,该源码是gpl的,商业应用对这个比较不感冒,可能更愿意自己基于Qt来实现一个。用纯Qt写输入法,如果不涉及到中文输入,那还是非常简单的,只需要将按钮上的字符用键盘事件发给焦点的控件即可。如果需要中文输入,最简单的做法是通过查询字库数据库来获取当前拼音对应的汉字,然后模拟键盘事件发送给焦点控件,好处是代码简单思路简单,缺点是性能堪忧,字库体积大,查询效率低,需要全拼才能找到合适的词语。复杂点的做法就是用谷歌开源的输入法引擎,查阅Qt自己的输入法源码,也是用的那个引擎,new出类,然后调用里面的函数接口,会返回对应的汉字,性能非常好。
谷歌开源的输入法引擎是标准的C++写的,所以可以非常方便的支持Qt4到Qt6,就不会局限于只能Qt5.7以后,输入法面板自己编写自己控制,自由度高,同时还可以加入简体繁体切换,特殊字符面板切换。其实可以复用很多按钮,比如在特殊字符这块,特殊字符往往一个面板不够放,可能要至少3个面板才能涵盖大部分的特殊字符,所有专门放了个特殊字符的面板按钮集合,通过翻页切换特殊字符,将对应的特殊字符文本设置到对应的按钮上,按钮单击后,识别按钮上的文本,然后再模拟键盘事件发送给焦点的控件即可。根据此思路其实可以拓展成多国语言输入法,根据大致的观察,多国语言基本上就是一些类似特殊字符的文本,将那些文本作为数据插入到焦点控件即可。
二、功能特点
- 纯QWidget编写,原创输入法机制,没有任何第三方动态库的依赖。
- 支持各种Qt版本,包括Qt4、Qt5、Qt6及后续版本。
- 支持各种编译器,包括mingw、msvc、gcc、clang、wasm等。
- 支持各种目标平台,包括windows、linux、macos、android、嵌入式linux等。
- 支持任意控件输入,包括文本框、微调框、可编辑下拉框、表格行等,以及网页中的输入控件。
- 支持中文、英文、数字、繁体、特殊字符、字母大小写等输入,可以自由切换。
- 无需更改原有项目代码,不用任何额外代码,自动识别需要输入的控件,弹出输入法面板,不需要输入法代码写得到处都是。
- 使用极为方便,通过源码集成到对应项目,源码是一个pri组件,只要在项目的pro文件引入即可。
- 接口极其丰富,在众多输入应用场景中不断迭代完善至今。
- 界面清晰简洁,UI美观友好,高仿IOS输入法,非常适合触摸设备。
- 顶部单行文字面板和弹出多行多列文字面板选词,支持滑动选词。
- 具有词汇记忆功能,之前选中过的词语放到候选词最前面。
- 具有自由造词功能,可以直接打开词汇文件写入自定义词组,最高级别显示。
- 造词支持单个拼音多个汉字,自动调整优先级。
- 内置数字小键盘,在微调框这种只需要输入数字的地方,自动弹出数字小键盘,更美观。
- 可通过设置弱属性,控制是弹出全键盘的数字面板还是数字小键盘。
- 可设置回车后自动隐藏输入法面板还是要执行插入回车换行符。
- 可对部分不需要输入的输入框设置禁用输入法。
- 多版面字符页面,可以自行拓展各种字符展示,可用于多语言输入。
- 输入法面板尺寸自由设置,采用布局自适应任何分辨率,同时适用于一些小分辨率的设备。
- 输入法面板位置支持控件正下方/正上方、永远居中、底部拉伸填充等多种方式。
- 界面自适应屏幕大小,输入法弹出位置为控件底部时,当超过桌面右边或者底部时,自动调整位置。
- 支持Qt程序嵌入的浏览器中的网页中的文本框等控件的输入。
- 可以分别设置面板按键字体大小、候选词字体大小、图标尺寸、顶部高度等。
- 属性控制数字输入,例如需要文本框默认弹出的是数字面板,则设置代码 ui->lineEdit->setProperty("flag", "number")。
- 属性控制大写输入,例如需要文本框默认输入字母永远大写,则设置代码 ui->lineEdit->setProperty("upper", true)。
- 自由控制需要显示输入法和不需要显示输入法,当某些控件不需要弹出输入法,只需要对应不需要弹出输入法的控件设置属性noinput为真即可。例如ui->lineEdit->setProperty("noinput", true)。
- 实现了长按超过500毫秒重复执行按下的键的功能。例如长按退格键,不断删除。
- 支持单拼、全拼、模糊拼音输入,智能分页算法,可任意翻页查看汉字词组。
- 默认自带5种皮肤颜色,可通过代码设置皮肤样式,用户也可用QSS自定义皮肤。
- 谷歌内核的输入法引擎,品质保证,字库文件1MB,不依赖数据库,资源占用低效率极高。支持模糊拼音,比如nh=你好。
- 可选windows专有版本,支持外部程序输入,比如输入到记事本、QQ聊天窗口等。
- 可选硬键盘同步输入版本,外接实体键盘,类似搜狗输入法弹出小的候选词面板,可以快捷键切换输入法状态。
- 整个输入法核心代码行数1000行左右,非常小,不会对程序体积造成负担。
- 代码结构极为清晰,注释详细,非常容易阅读和理解,可自行修改和拓展满足各种需求。
三、代码使用
- 将core_input2019和core_pinyin整个目录放到你的项目的pro同一级别目录中。
- 在你的主程序的pro文件中加一行 include($$PWD/core_input2019/core_input2019.pri)
- 在你的程序的main函数中引入头文件 #include "core_input2019/frminput2019.h"
- 在你的程序的main函数中加几行代码。
QApplication a(argc, argv);
frmInput2019::Instance()->hide();
frmInput2019::Instance()->setFontInfo("MicroSoft Yahei", 18, 16);
frmInput2019::Instance()->setFixedSize2(650, 310);
frmInput2019::Instance()->setIconSize(26, 26);
frmInput2019::Instance()->setTopHeight(60);
QWidget w;
w.show();
return a.exec();
- 将源码下的inputfile文件夹下所有文件(即字库文件)复制到可执行文件同一目录。
- 详细的输入法函数接口使用参见main.cpp和frminputtool.cpp以及frmInput2019.h头文件中的接口,都有详细注释说明。
四、效果图
五、体验地址
- 体验地址:https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A 提取码:o05q 文件名:bin_input.zip
- 国内站点:https://gitee.com/feiyangqingyun
- 国际站点:https://github.com/feiyangqingyun
- 个人主页:https://blog.csdn.net/feiyangqingyun
- 视频主页:https://space.bilibili.com/687803542/