Android平台QLineEdit内容不显示Bug的有效Workaround寻求

在从Qt 6.2.2迁移至6.9.0的过程中，遇到QLineEdit输入内容仅在关闭虚拟键盘后才显示的回归问题，该问题自Qt 6.7.2起存在且官方暂未修复。

问题复现代码 #

#include <QApplication>
#include <QMainWindow>
#include <QVBoxLayout>
#include <QLineEdit>
int main( int argc, char* argv[] )
{
    QApplication app( argc, argv );
    QMainWindow wnd;
    QWidget widget( &wnd );
    wnd.setCentralWidget( &widget );
    widget.setLayout( new QVBoxLayout(&widget) );
    widget.layout()->addWidget( new QLineEdit() );
    widget.layout()->addWidget( new QLineEdit() );
    wnd.show();
    return app.exec();
}

原尝试方案的问题 #

直接在QApplication::notify中强制转换接收者为QLineEdit存在类型安全风险，且仅使用preeditString无法完整处理输入事件（比如提交的文本、删除操作），导致方案无效。

可行临时解决方案 #

方案1：重写QLineEdit的输入方法事件

通过自定义QLineEdit子类，手动处理输入事件并强制刷新界面，确保输入内容实时显示：

#include <QLineEdit>
#include <QInputMethodEvent>

class FixedLineEdit : public QLineEdit
{
    Q_OBJECT
public:
    using QLineEdit::QLineEdit;

protected:
    void inputMethodEvent(QInputMethodEvent *event) override
    {
        // 先调用基类逻辑，避免破坏原有输入处理流程
        QLineEdit::inputMethodEvent(event);
        
        // 合并删除、提交和预编辑文本，更新内容
        QString updatedText = text();
        updatedText.remove(updatedText.length() - event->removedLength(), event->removedLength());
        updatedText += event->commitString() + event->preeditString();
        
        if (updatedText != text()) {
            setText(updatedText);
            // 强制触发界面刷新
            update();
        }
    }
};

使用时将原代码中的QLineEdit替换为FixedLineEdit即可。

方案2：全局事件过滤器

通过事件过滤器统一处理所有QLineEdit的输入事件，无需修改现有控件类型：

#include <QObject>
#include <QLineEdit>
#include <QInputMethodEvent>

class InputFixFilter : public QObject
{
    Q_OBJECT
protected:
    bool eventFilter(QObject *watched, QEvent *event) override
    {
        if (event->type() == QEvent::InputMethod) {
            QLineEdit* lineEdit = qobject_cast<QLineEdit*>(watched);
            if (!lineEdit) {
                return QObject::eventFilter(watched, event);
            }
            
            QInputMethodEvent* inputEvent = static_cast<QInputMethodEvent*>(event);
            QString updatedText = lineEdit->text();
            // 处理删除操作
            updatedText.remove(updatedText.length() - inputEvent->removedLength(), inputEvent->removedLength());
            // 合并提交文本和预编辑文本
            updatedText += inputEvent->commitString() + inputEvent->preeditString();
            
            if (updatedText != lineEdit->text()) {
                lineEdit->setText(updatedText);
                lineEdit->update();
            }
        }
        return QObject::eventFilter(watched, event);
    }
};

// 在main函数中安装过滤器
int main( int argc, char* argv[] )
{
    QApplication app( argc, argv );
    
    InputFixFilter inputFilter;
    qApp->installEventFilter(&inputFilter);
    
    QMainWindow wnd;
    QWidget widget( &wnd );
    wnd.setCentralWidget( &widget );
    widget.setLayout( new QVBoxLayout(&widget) );
    widget.layout()->addWidget( new QLineEdit() );
    widget.layout()->addWidget( new QLineEdit() );
    wnd.show();
    return app.exec();
}

注意事项 #

• 以上方案为临时 workaround，待官方修复该回归问题后建议移除；
• 测试时需覆盖多种输入场景：英文输入、中文拼音/五笔等输入法的预编辑、删除/回退操作；
• 针对Android平台，若仍存在兼容性问题，可尝试调用QInputMethod::update()主动触发输入法同步。

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