0
0

QT5 Virtual Keyboard实现自适应悬浮键盘（多种方法详细记录）

  1.     项目需求实现悬浮键盘，点击QLineEdit或QTextEdit自动弹出自适应悬浮键盘，尝试了以下几种方法后选择了修改QT Virtual Keyboard源码。在这里把其他方法/想法也列出来做一下记录。
  3.     项目环境：QT5.13.2  VS2017

方法1：调用windows自带系统软件盘

介绍

  1.     windows自带软键盘分为osk.exe以及tabtip.exe。这里简单阐述一下个人理解的两者区别，osk.exe就是日常使用时的系统软件盘，tabtip.exe是windows平板模式时使用的系统软件盘，仅响应平板模式时命令，所以普通模式时调用tabtip是没有弹出的。
  3.     osk.exe 位于 C:\Windows\System32\osk.exe；
  5.     tabtip.exe 位于 C:\Program Files\Common Files\microsoft shared\ink\TabTip.exe。
  7.     直接调用可以win+R打开运行窗口输入osk或tabtip查看。

Windows10中的osk（上）和tabtip（下）：

代码调用

  1.     曾尝试重写QTextEdit以及QLineEdit的点击响应事件mousePressEvent(QMouseEvent *event)，以实现点击信息框后弹出系统软键盘。但是很遗憾失败了，点击后并不会弹出osk或tabtip系统软键盘，具体原因未做探究，欢迎各位补充。想要尝试的童鞋可以查看参考文献4。
  3.     下文提供的方法为：点击按钮弹出windows系统软件盘。（以下为osk调用代码，电脑无平板模式，未尝试tabtip）

QtWidgetsApplication.ui

  1.      这里直接使用QT Designer在ui界面中添加Push Button

** QtWidgetsApplication.h**

  1. //软键盘的头文件
  2. #include <Windows.h>
  3. #pragma comment(lib, "user32.lib")
  5. #include <QtWidgets/QMainWindow>
  6. #include "ui_QtWidgetsApplication1.h"
  7. using namespace std;
  9. class QtWidgetsApplication : public QMainWindow
  10. {
  11.     Q_OBJECT
  13. public:
  14.     QtWidgetsApplication1(QWidget *parent = Q_NULLPTR);
  16. private:
  17.     Ui::QtWidgetsApplicationClass ui;
  18. }

QtWidgetsApplication.cpp

  1. #include "QtWidgetsApplication.h"
  3. QtWidgetsApplication::QtWidgetsApplication(QWidget *parent)
  4.     : QMainWindow(parent)
  5. {
  6.     ui.setupUi(this);
  7.     // 按钮点击触发弹出osk.exe
  8.     connect(ui.textButton, &QPushButton::clicked, [=]() {
  9.         PVOID OldValue = nullptr;
  10.         BOOL bRet = Wow64DisableWow64FsRedirection(&OldValue);
  11.         QString csProcess = "C:\\Windows\\System32\\osk.exe";
  12.         QString params="";
  13.         ShellExecute(nullptr, L"open", (LPCWSTR)csProcess.utf16(), (LPCWSTR)params.utf16(), nullptr, SW_SHOWNORMAL);
  14.         if (bRet)
  15.         {
  16.             Wow64RevertWow64FsRedirection(OldValue);
  17.         }
  18.     });
  19. }

方法2：用大佬们公开的自制键盘

介绍

  1.     参考文献[5]到参考文献[9]是搜索过程中找到的一些大佬的开源自制虚拟键盘，仅列举能找到的部分连接，其余连接已经消失在浏览器历史记录中找不到了。但是自制的美观度啥的还是不如QT自带的虚拟键盘，所以采用了方法3。

方法3：修改QT自带Virtual Keyboard代码实现定位悬浮

介绍

修改前QT Virtual Keyboard效果如下图，数字键盘（上），常规键盘（下）：

  1.      可以看到QT自带的虚拟键盘会自动占据半个屏幕，挡住了界面，使用体验略有欠缺。

修改后实际效果如下图所示，数字键盘（上），常规键盘（下）：（PS：功能实验项目，界面过于杂乱，勿介意）

  1.      修改后的QT虚拟键盘缩小了键盘尺寸，以及实现了根据QLineEdit和QTextEdit位置自适应悬浮。

代码调用及编译步骤

  1.     以下位置信息以本人电脑各部件位置信息为例，具体位置可根据个人安装位置进行调整。

（1）首先你的QT要有源码，如果你在最初安装的时候已经安装了源码那么源码位于D:\Qt\Qt5.13.2\5.13.2\Src。如果在安装时没有选择源码，可进入各版本QT源码下载进行下载。本文环境为QT5.13.2，具体选择路径如下图所示。

  1.     下载后解压至D:\Qt\Qt5.13.2\5.13.2\qt-everywhere-src-5.13.2

** （2）**进入目录D:\Qt\Qt5.13.2\5.13.2\qt-everywhere-src-5.13.2\qtvirtualkeyboard\src\virtualkeyboard，点击下方文件打开QT Creator。

（3）修改以下四个文件。（在这里感谢参考文献[9]的大佬）

virtualkeyboard.pro

  1.      在virtualkeyboard.pro中加入下方代码（此处包含上下文部分代码，方便大家找到具体位置）
  1. QT += qml quick gui gui-private core-private
  2. # 加入widgets，自动载入相关库
  3. QT += widgets
  5. CONFIG += qtquickcompiler

** InputPanel.qml**

  1.      这里由于篇幅问题将源码中大段注释进行删除，添加代码部分已在下方标出。
  1. import QtQuick 2.0
  2. import QtQuick.VirtualKeyboard 2.1
  3. // 加入
  4. import QtQuick.Window 2.2
  6. Item {
  7.     id: inputPanel
  8.     property alias active: keyboard.active
  9.     property bool externalLanguageSwitchEnabled
  10.     signal externalLanguageSwitch(var localeList, int currentIndex)
  11.     property alias keyboard: keyboard
  12.     readonly property bool __isRootItem: inputPanel.parent != null && inputPanel.parent.parent == null
  14.     SelectionControl {
  15.         objectName: "selectionControl"
  16.         x: -parent.x
  17.         y: -parent.y
  18.         enabled: active && !keyboard.fullScreenMode && !__isRootItem
  19.     }
  21.     implicitHeight: keyboard.height
  22.     Keyboard {
  23.         id: keyboard
  24.         // 将以下内容注释掉
  25. //        anchors.left: parent.left
  26. //        anchors.right: parent.right
  27. //        anchors.bottom: parent.bottom
  29.         // 以下为添加代码
  30.         // 获取锚点
  31.         anchors.horizontalCenter: parent.horizontalCenter
  32.         // 键盘宽度（可根据需要进行修改）
  33.         width: Screen.desktopAvailableWidth * 2 / 5
  34.         states: State {
  35.                 name: "visible";
  36.                 when: keyboard.active;
  37.                 PropertyChanges {
  38.                     target: keyboard;
  39.                     y: getInputY()
  40.                 }
  41.             }
  42.         transitions: Transition {
  43.                 from: "";
  44.                 to: "visible";
  45.                 reversible: true;
  46.                 ParallelAnimation {
  47.                     NumberAnimation {
  48.                         properties: "y";
  49.                         duration: 250;
  50.                         easing.type: Easing.InOutQuad;
  51.                     }
  52.                 }
  53.             }
  54.         // 获取锚点坐标Y值
  55.         function getInputY(){
  56.                 if(InputContext.inputItemGeometry.y + InputContext.inputItemGeometry.height + keyboard.height <= Screen.desktopAvailableHeight){
  57.                     return InputContext.inputItemGeometry.y + InputContext.inputItemGeometry.height
  59.                 }
  60.                 else if(InputContext.inputItemGeometry.y - keyboard.height - 100 >= 0)
  61.                 {
  62.                     return InputContext.inputItemGeometry.y - keyboard.height - 50
  63.                 }
  64.                 else
  65.                 {
  66.                       return Screen.desktopAvailableHeight - keyboard.height
  67.                 }
  68.             }
  69.         // 添加代码部分结束
  70.     }
  71.     MouseArea {
  72.         z: -1
  73.         anchors.fill: keyboard
  74.         enabled: active
  75.     }
  77.     Binding {
  78.         target: InputContext.priv
  79.         property: "keyboardRectangle"
  80.         value: mapToItem(null,
  81.                          __isRootItem ? keyboard.x : x,
  82.                          (__isRootItem ? keyboard.y : y) + keyboard.wordCandidateView.currentYOffset - (keyboard.shadowInputControl.visible ? keyboard.shadowInputControl.height : 0),
  83.                          keyboard.width,
  84.                          keyboard.height - keyboard.wordCandidateView.currentYOffset + (keyboard.shadowInputControl.visible ? keyboard.shadowInputControl.height : 0))
  85.         when: !InputContext.animating
  86.     }
  87. }

** qvirtualkeyboardinputcontext.h（Headers文件夹内）**

  1. #ifndef QVIRTUALKEYBOARDINPUTCONTEXT_H
  2. #define QVIRTUALKEYBOARDINPUTCONTEXT_H
  4. #include <QObject>
  5. #include <QRectF>
  6. #include <QLocale>
  7. #include <QInputMethodEvent>
  8. #include <QInputMethod>
  9. #include <QtVirtualKeyboard/qvirtualkeyboard_global.h>
  10. // 加入头文件
  11. #include <QtWidgets/QWidget>
  13. QT_BEGIN_NAMESPACE
  15. namespace QtVirtualKeyboard {
  16. class PlatformInputContext;
  17. }
  18. class QVirtualKeyboardInputEngine;
  19. class QVirtualKeyboardInputContextPrivate;
  21. class QVIRTUALKEYBOARD_EXPORT QVirtualKeyboardInputContext : public QObject
  22. {
  23.     Q_OBJECT
  24.     // ......此处篇幅以及直观原因省略55-76行
  25.     Q_PROPERTY(QVirtualKeyboardInputContextPrivate *priv READ priv CONSTANT)
  27.     // 加入
  28.     Q_PROPERTY(QRectF inputItemGeometry READ inputItemGeometry CONSTANT)
  30. public:
  31.     explicit QVirtualKeyboardInputContext(QObject *parent = nullptr);
  32.     ~QVirtualKeyboardInputContext();
  34.     // 加入
  35.     QRectF inputItemGeometry();
  37.     bool isShiftActive() const;
  38.     // ......此处篇幅以及直观原因省略91-119行
  40. Q_SIGNALS:
  42.     // ......此处篇幅以及直观原因省略123-139行
  44. private:
  46.     QScopedPointer<QVirtualKeyboardInputContextPrivate> d_ptr;
  47. };
  49. QT_END_NAMESPACE
  51. #endif

** qvirtualkeyboardinputcontext.cpp（Sources文件夹内）**

  1. // 加入内容
  2. QRectF QVirtualKeyboardInputContext::inputItemGeometry()
  3. {
  4.     QWidget* pInputItem = static_cast<QWidget*>(inputItem());
  5.     return pInputItem ? QRectF((static_cast<QWidget*>(pInputItem->parent()))->mapToGlobal(pInputItem->geometry().topLeft()), pInputItem->geometry().size()) : QRectF(0,0,0,0);
  6. }

（4）进入下方工具

  1.     进入目录 ：D:\Qt\Qt5.13.2\5.13.2\qt-everywhere-src-5.13.2\qtvirtualkeyboard\src\virtualkeyboard

  1.      依次执行qmake、nmake、nmake install

** （5）**VS2017中进入Qt Project Settings，加入Vitual Keyboard模块。

** （6）**在main.cpp中加入以下代码

  1. #include "QtWidgetsApplication1.h"
  2. #include "Products.h"
  3. #include <string>
  4. #include <QtWidgets/QApplication>
  6. int main(int argc, char *argv[])
  7. {
  8.     qputenv("QT_IM_MODULE", QByteArray("qtvirtualkeyboard")); // 虚拟键盘调用
  10.     QApplication a(argc, argv);
  11.     QtWidgetsApplication1 w;
  12.     w.show();
  13.     return a.exec();
  14. }

** （7）**数字键盘和常用键盘的选择见如下属性

记录出现的部分问题

（1）qvirtualkeyboardinputcontext.obj : error LNK2019: 无法解析的外部符号 "__declspec(dllimport) public: class QPoint __cdecl QWidget::mapToGlobal(class QPoint const &)const " (_imp?mapToGlobal@QWidget@@QEBA?AVQPoint@@AEBV2@@Z)，该符号在函数 "public: class QRectF __cdecl QVirtualKeyboardInputContext::inputItemGeometry(void)" (?inputItemGeometry@QVirtualKeyboardInputContext@@QEAA?AVQRectF@@XZ) 中被引用
....\lib\Qt5VirtualKeyboard.dll : fatal error LNK1120: 1 个无法解析的外部命令

（2）fatal error C1083: 无法打开包括文件: “QWidget”: No such file or directory
fallbackinputmethod.cpp

  1.     出现以上两种问题，请排查以下内容：
  3.     1、请在第三步中**virtualkeyboard.pro**查看是否加入QT += widgets；
  5.     2、查看第四步中进入目录是否为D:\Qt\Qt5.13.2\5.13.2\qt-everywhere-src-5.13.2\qtvirtualkeyboard\src\virtualkeyboard。若仅到D:\Qt\Qt5.13.2\5.13.2\qt-everywhere-src-5.13.2\qtvirtualkeyboard会出现以上问题。
  7.     仍出现以下问题，尝试以下两种方法：

** 方法一：**用以下代码替换QT += widgets

  1. greaterThan(QT_MAJOR_VERSION, 4):QT += widgets

方法二：加入库

  1. INCLUDEPATH += D:/Qt/Qt5.13.2/5.13.2/msvc2017_64/include/QtWidgets
  2. LIBS += D:/Qt/Qt5.13.2/5.13.2/msvc2017_64/lib/Qt5Widgets.lib

参考文献：

[1] Windows下C++调用系统软键盘及其需要注意的点_FlushHip的博客-CSDN博客

[2]qt调用windows键盘

[3]如何将存在任务管理器中隐藏的tabtip键盘显示出来

[4]QT给控件QLineEdit添加clicked()事件方法_gloria.Momo的博客-CSDN博客_qt clicked

[5]qt模拟键盘_开心an的博客-CSDN博客

[6]QT 虚拟键盘 可进行中英输入【C++】_每晚秃头的程序员的博客-CSDN博客_qt5.12.12虚拟键盘只保留中英文输入法

[7]qt制作软键盘（虚拟键盘）_努力拱白菜的博客-CSDN博客_qt 虚拟键盘

[8]轻量级Qt键盘-实现篇 - 知乎

[9]Qt5 Virtual Keyboard C++集成与实现二（自适应位置）-爱易默博客

[10]QT pro QT+= widgets终极总结_梦幽风的博客-CSDN博客_qt+=widgets

标签： qt5 c++ visual studio
本文转载自: https://blog.csdn.net/qq_41516296/article/details/127677551
版权归原作者 白茯苓 所有， 如有侵权，请联系我们删除。
登录后发布评论

“QT5 Virtual Keyboard实现自适应悬浮键盘（多种方法详细记录）”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

网络安全法-网络运行安全

使用selenium/drissionpage时如何阻止chrome自动跳转http到https

docker desktop 里部署的Open WebUI 管理员密码忘记了的处理方法

在ubuntu20.04中搭建onsite比赛运行环境

利用开源的低代码表单设计器FcDesigner高效管理和渲染复杂表单结构

Kafka学习笔记

【前端】浏览器输入url到页面呈现发生了什么？