Qt QWebEngineView过滤QInputMethodQueryEvent及自定义键盘交互优化问询

我正在用Qt为嵌入式系统开发带自定义键盘的简易网页浏览器，在通过QWebEngineView实现与网页输入区域的交互时遇到困难。

已尝试的两种方案均存在问题：

• 使用QWebEnginePage::runJavaScript与页面交互唤起键盘，虽能实现但可靠性不足，有诸多缺陷；
• 通过事件过滤器捕获QEvent::InputMethodQuery事件，点击网页输入区域时该事件会多次触发，方案不稳定。

相关代码片段（m_view为QWebEngineView指针）：

void WebBrowser::activate(void)
{
    m_view->setUrl(QUrl(tr("https://www.google.com/")));
    m_view->show();
    // RenderWidgetHostViewQtDelegateWidget is created after loading a page
    // so you must access it after load() or setHtml().
    QWidget *render_widget = m_view->focusProxy();
    render_widget->installEventFilter(this);
    render_widget->setFocusPolicy(Qt::ClickFocus);
}

bool WebBrowser::eventFilter(QObject *obj, QEvent *event)
{
    if (event->type() == QEvent::InputMethodQuery)
    {
        auto inputEvent = static_cast<QInputMethodQueryEvent *>(event);
        if (inputEvent->queries().testFlag(Qt::ImCursorRectangle))
        {
            obj->removeEventFilter(this);
            callKeyboard();
            obj->installEventFilter(this);
        }
        return true;
    }
    else
    {
        return QObject::eventFilter(obj, event);
    }
}

另外还尝试过QEvent::FocusIn、QEvent::RequestSoftwareInputPanel以及QWidget::focusInEvent，均未达到预期效果。

改进建议 #

1. 优化InputMethodQuery事件处理逻辑 #

原代码中移除再重新安装事件过滤器的操作无意义，反而易引发逻辑混乱。添加状态标记可避免重复唤起键盘，同时注意不能拦截该事件（否则会导致网页输入行为异常）：

// 在WebBrowser类中添加成员变量
bool m_keyboardActive = false;

bool WebBrowser::eventFilter(QObject *obj, QEvent *event)
{
    if (event->type() == QEvent::InputMethodQuery)
    {
        auto inputEvent = static_cast<QInputMethodQueryEvent *>(event);
        if (inputEvent->queries().testFlag(Qt::ImCursorRectangle))
        {
            if (!m_keyboardActive) {
                callKeyboard();
                m_keyboardActive = true;
            }
            return false; // 必须返回false，让QWebEngineView正常处理输入查询
        }
    }
    // 监听焦点离开事件，重置键盘激活状态
    else if (event->type() == QEvent::FocusOut) {
        m_keyboardActive = false;
    }
    return QObject::eventFilter(obj, event);
}

2. 结合QWebEnginePage选择变更信号辅助判断 #

通过QWebEnginePage::selectionChanged信号，可更精准判断是否处于可输入状态：

// 在WebBrowser构造函数中连接信号
connect(m_view->page(), &QWebEnginePage::selectionChanged, this, [this]() {
    QWebEnginePage::SelectionSelectionFlags flags = m_view->page()->selectionFlags();
    // 无选中内容但存在光标，说明处于可编辑区域
    if (!(flags & QWebEnginePage::SelectionContainsText) && m_view->page()->hasSelection()) {
        if (!m_keyboardActive) {
            callKeyboard();
            m_keyboardActive = true;
        }
    }
});

3. 正确处理RequestSoftwareInputPanel事件 #

嵌入式系统中，QEvent::RequestSoftwareInputPanel是唤起软键盘的标准事件，可拦截并替换为自定义键盘逻辑：

bool WebBrowser::eventFilter(QObject *obj, QEvent *event)
{
    if (event->type() == QEvent::RequestSoftwareInputPanel) {
        if (!m_keyboardActive) {
            callKeyboard();
            m_keyboardActive = true;
        }
        return true; // 拦截系统默认软键盘唤起
    }
    else if (event->type() == QEvent::CloseSoftwareInputPanel) {
        m_keyboardActive = false;
        // 此处添加关闭自定义键盘的逻辑
        return true;
    }
    // 其他事件处理逻辑...
    return QObject::eventFilter(obj, event);
}

同时需确保QWebEngineView的输入相关配置正确：

m_view->page()->settings()->setAttribute(QWebEngineSettings::FocusOnNavigationEnabled, true);
m_view->setInputMethodHints(Qt::ImhNoAutoUppercase | Qt::ImhNoPredictiveText);

4. 延迟获取渲染窗口 #

页面加载是异步过程，原代码中直接获取focusProxy()可能时机不对，建议在loadFinished信号中安装事件过滤器：

connect(m_view, &QWebEngineView::loadFinished, this, [this](bool ok) {
    if (ok) {
        QWidget *render_widget = m_view->focusProxy();
        if (render_widget) {
            render_widget->installEventFilter(this);
            render_widget->setFocusPolicy(Qt::ClickFocus);
        }
    }
});

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