Qt 6.8.3中QVirtualKeyboard无法缩放的问题求助

在Windows 11系统上使用Qt 6.8.3（MinGW 64位）创建Qt Widget HelloWorld应用，调试QVirtualKeyboard缩放功能时遇到问题：UI中任意spinbox获得焦点时，虚拟键盘可正常显示工作，但会铺满整个屏幕宽度，高度占屏幕近一半，需重新调整键盘尺寸。当前测试用main.cpp代码如下：

#include "src/mainwindow.h"
#include <QApplication>
#include <QtVirtualKeyboard/QtVirtualKeyboard>

int main(int argc, char *argv[])
{

    qputenv("QT_VIRTUALKEYBOARD_HEIGHT_SCALE", "0.6"); // 60% of default height
    qputenv("QT_IM_MODULE", QByteArray("qtvirtualkeyboard"));
    //qputenv("QT_VIRTUALKEYBOARD_STYLE", QByteArray(":/customStyle"));

    QApplication a(argc, argv);

    MainWindow w;
    w.show();


    return a.exec();
}

解决方法 #

• 使用环境变量同时控制宽高比例
  仅设置高度缩放无法限制宽度，可添加宽度比例环境变量，在QApplication实例化前设置：

  qputenv("QT_VIRTUALKEYBOARD_WIDTH_SCALE", "0.8"); // 80% of default width
  

  这样键盘会按默认尺寸的80%宽度、60%高度显示，不会铺满屏幕。

• 自定义样式固定尺寸并居中
  如果需要更精确的尺寸控制，启用自定义样式：

  1. 在项目中创建customkeyboard.qss样式文件，添加以下内容：

     VirtualKeyboardContainer {
         max-width: 800px; /* 固定最大宽度 */
         max-height: 300px; /* 固定最大高度 */
         margin: 0 auto; /* 让键盘在屏幕底部居中 */
     }
     

  2. 将样式文件添加到Qt资源文件（.qrc）中，路径设为:/customStyle
  3. 取消代码中QT_VIRTUALKEYBOARD_STYLE的注释，启用自定义样式：

     qputenv("QT_VIRTUALKEYBOARD_STYLE", QByteArray(":/customStyle"));
     

• 通过QVirtualKeyboardSettings动态调整
  若需运行时调整尺寸，可使用QVirtualKeyboardSettings类替代环境变量，在QApplication初始化后设置：

  #include <QtVirtualKeyboard/QVirtualKeyboardSettings>
  
  // ...
  
  QApplication a(argc, argv);
  QVirtualKeyboardSettings::setHeightScale(0.6);
  QVirtualKeyboardSettings::setWidthScale(0.8);
  

  这种方式支持在程序运行中根据需求实时修改键盘缩放比例。

内容的提问来源于stack exchange，提问作者taimoor1990