当前位置：首页 > article >正文

qt 自带虚拟键盘的编译使用记录

article 2025/3/17 18:57:12

一、windows 下编译

使用vs 命令窗口，分别执行：

qmake CONFIG+="lang-en_GB lang-zh_CN"

nmake

nmake install

如果事先没有指定需要使用的输入法语言就进行过编译，则需要先执行 nmake distclean 清理后执行 qmake 才能生效。

二、关于源码的理解

1、虚拟键盘是以插件的形式启动的，qt 程序运行后会自动遍历加载 qt 安装目录下...\plugins\platforminputcontexts 目录中的插件dll。如果安装了虚拟键盘QtVirtualKeyboard 则会在 platforminputcontexts 目录下存在 QtVirtualKeyboard 的插件dll

2、QtVirtualKeyboard 插件代码如下：运行时如果设置了对应的环境遍历，则插件正常加载




static const char pluginsUri[] = "QtQuick.VirtualKeyboard.Plugins";
static const char pluginName[] = "qtvirtualkeyboard";
static const char inputMethodEnvVarName[] = "QT_IM_MODULE";

QStringList QVirtualKeyboardPlugin::keys() const
{
    return QStringList(QLatin1String(pluginName));
}

QPlatformInputContext *QVirtualKeyboardPlugin::create(const QString &system, const QStringList &paramList)
{
    Q_UNUSED(paramList);

    /*.............*/

    //这里就算比对 环境变量，如果是 QT_IM_MODULE 和 qtvirtualkeyboard 则相当于使用了这个插件
    if (!qEnvironmentVariableIsSet(inputMethodEnvVarName) || qgetenv(inputMethodEnvVarName) != pluginName)
        return Q_NULLPTR;

    if (system.compare(system, QLatin1String(pluginName), Qt::CaseInsensitive) != 0)
        return Q_NULLPTR;
    
    //创建输入法上下文
    PlatformInputContext *platformInputContext = new PlatformInputContext();

    /*.............*/
}

3、加载后应该会自动调用 PlatformInputContext::update 函数，内部创建 DesktopInputPanel 输入面板并创建视图

4、视图是 QQuickView 的子类，用于加载 qml 界面。上图中createView 将会加载显示InPutPanel.qml 进行显示

三、调整大小与可拖动

1、网上的方法：在 DesktopInputPanel 类的 show 函数中修改视图的大小，可以达到效果。但是由于视图的大小决定了 qml 界面可显示的范围，若修改视图大小，则qml 只能在改区域内显示，不号。所以该处不修改。

2、只需要在InputPanel.qml 修改即可，该文件中的 Keyboard 即是整个键盘，直接修改其宽度即可，高度设置不生效（应该是内部自动根据宽度调整的），位置修改为锚定父对象底部。

3、实现可拖动，修改 MouseArea 代码

    property real mouseXTMP: 0
    property real mouseYTMP: 0
    MouseArea {
        z: -1
        anchors.fill: parent //修改为 Keyboard，这样整个窗口都可以点击拖动
        enabled: active

        onPressed: {
            mouseXTMP = mouseX
            mouseYTMP = mouseY
        }
        onPositionChanged: {
            inputPanel.x = mouseX + inputPanel.x - mouseXTMP
            inputPanel.y = mouseY + inputPanel.y - mouseYTMP
        }
    }

4、屏蔽Binding 的代码，该代码具体含义不明，大概是会改变到视图可视的范围大小，会造成与在DesktopInputPanel 类的 show 函数中修改视图的大小一样的问题。可以直接注释调。