如何关闭含QTextEdit的子QDialog后隐藏Android虚拟键盘

我在开发Android平台的Qt程序时遇到如下问题：弹出包含QTextEdit输入框的子窗口时，虚拟键盘可正常弹出（输入框获焦时）和关闭（点击键盘向下箭头）；但按返回键关闭子对话框后，虚拟键盘会自动在父窗口上方重新弹出。

复现代码 #

父窗口代码 #

Dialog::Dialog(QWidget *parent)
    : QDialog(parent)
{
    QVBoxLayout * mainLayout = new QVBoxLayout;
    this->setLayout(mainLayout);

    QPushButton * pTextDlgButton = new QPushButton("Text dlg",this);
    connect(pTextDlgButton , SIGNAL(clicked()) , this , SLOT(OnTextDlgPress()));
    mainLayout->addWidget(pTextDlgButton);
}

Dialog::~Dialog() {}


void Dialog::OnTextDlgPress()
{
    QTextDlg dlg;
    dlg.exec();
}

子窗口代码 #

QTextDlg::QTextDlg()
{
    QVBoxLayout * mainLayout = new QVBoxLayout;
    this->setLayout(mainLayout);

    QTextEdit * pTextEdit=new QTextEdit();

    mainLayout->addWidget(pTextEdit);
}

解决方案 #

针对常规方法无效的情况，可尝试以下针对性方案：

• 在子对话框关闭时强制转移焦点
  重写子对话框的closeEvent，将焦点转移到对话框本身（非输入控件），避免输入框保留焦点导致系统误触键盘：

  void QTextDlg::closeEvent(QCloseEvent *event)
  {
      setFocus(); // 将焦点转移到对话框自身
      QDialog::closeEvent(event);
  }
  

• 父窗口在对话框关闭后主动抢占焦点
  在exec()执行完毕后，让父窗口中的非输入控件（比如触发子对话框的按钮）重新获得焦点，阻止系统弹出虚拟键盘：

  void Dialog::OnTextDlgPress()
  {
      QTextDlg dlg;
      dlg.exec();
      pTextDlgButton->setFocus(); // 让按钮重新获焦
  }
  

• 结合焦点清除与输入法隐藏
  在子对话框析构时，同时清除输入框焦点并显式隐藏输入法，双管齐下：

  QTextDlg::~QTextDlg()
  {
      if (pTextEdit) {
          pTextEdit->clearFocus(); // 清除输入框焦点
      }
      qApp->inputMethod()->hide(); // 强制隐藏输入法
  }
  

注：Android平台上Qt的焦点管理存在延迟特性，确保非输入控件及时获焦是解决此问题的核心，避免系统因找不到焦点控件而默认唤起虚拟键盘。

内容的提问来源于stack exchange，提问作者Дмитрий Неклюдов