Qt/C++中英输入法/嵌入式输入法/小数字面板/简繁切换/特殊字符/支持Qt456

news2024/11/18 9:37:01

一、前言

在嵌入式板子上由于没有系统层面的输入法支持，所以都绕不开一个问题，那就是在需要输入的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();