Qt QComboBox不同选择方式下光标行为不一致的问题解决需求

问题描述 #

1. 光标行为不一致 #

自定义对话框包含带搜索匹配功能的可编辑QComboBox（m_box）和QListWidget（m_lst），通过QCompleter实现搜索过滤后，三种操作下光标显示行为不统一：

• 直接鼠标点击m_box下拉列表项：m_box输入框无光标
• 搜索匹配后用上下键+回车选择项：m_box输入框无光标
• 搜索匹配显示候选项后鼠标点击选择：m_box输入框显示光标

期望效果：只要选中项属于m_box的预设候选项，m_box输入框就不显示光标；仅当鼠标点击m_box输入区域时才显示光标。

最小复现代码：

#include <QApplication>
#include <QDialog>
#include <QComboBox>
#include <QListWidget>
#include <QCompleter>
#include <QStringList>
#include <QVBoxLayout>
#include <QDebug>

class CustomDialog : public QDialog
{
    Q_OBJECT
public:
    CustomDialog(QWidget* parent = nullptr) : QDialog(parent)
    {
        QStringList items;
        items << "item1" << "item2";
        m_box = new QComboBox(this);
        m_box->setEditable(true);
        m_box->addItems(items);
        QCompleter* completer = new QCompleter(items, m_box);
        completer->setFilterMode(Qt::MatchContains);
        m_box->setCompleter(completer);

        m_lst = new QListWidget(this);
        m_lst->addItems(items);

        QVBoxLayout* layout = new QVBoxLayout(this);
        layout->addWidget(m_box);
        layout->addWidget(m_lst);

        connect(m_box, SIGNAL(activated(int)), this, SLOT(onSelChangedBox(int)));
    }

public slots:
    void onSelChangedBox(int iSel);

private:
    QComboBox* m_box;
    QListWidget* m_lst;
};

void CustomDialog::onSelChangedBox(int iSel)
{
    qDebug() << "clear focus of m_box";
    m_lst->setFocus();
}

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

    CustomDialog dlg;
    dlg.setFixedSize(300, 200);
    dlg.show();

    return a.exec();
}

#include "main.moc"

2. 多QComboBox下的双光标异常 #

新增第二个可编辑QComboBox（m_box2）后，若通过上述第三种方式选择m_box1的项，再点击m_box2，会出现双光标bug：m_box1已失去焦点，但光标仍显示在其输入框内。

复现代码：

#include <QApplication>
#include <QDialog>
#include <QComboBox>
#include <QListWidget>
#include <QCompleter>
#include <QStringList>
#include <QVBoxLayout>
#include <QDebug>

class CustomDialog : public QDialog
{
    Q_OBJECT
public:
    CustomDialog(QWidget* parent = nullptr) : QDialog(parent)
    {
        QStringList items;
        items << "item1" << "item2";
        m_box1 = new QComboBox(this);
        m_box1->setEditable(true);
        m_box1->addItems(items);
        QCompleter* completer1 = new QCompleter(items, m_box1);
        completer1->setFilterMode(Qt::MatchContains);
        m_box1->setCompleter(completer1);

        m_box2 = new QComboBox(this);
        m_box2->setEditable(true);
        m_box2->addItems(items);
        QCompleter* completer2 = new QCompleter(items, m_box2);
        completer2->setFilterMode(Qt::MatchContains);
        m_box2->setCompleter(completer2);

        m_lst = new QListWidget(this);
        m_lst->addItems(items);

        QVBoxLayout* layout = new QVBoxLayout(this);
        layout->addWidget(m_box1);
        layout->addWidget(m_box2);
        layout->addWidget(m_lst);

        connect(m_box1, SIGNAL(activated(int)), this, SLOT(onSelChangedBox(int)));
        connect(m_box2, SIGNAL(activated(int)), this, SLOT(onSelChangedBox(int)));
    }

public slots:
    void onSelChangedBox(int iSel);

private:
    QComboBox* m_box1;
    QComboBox* m_box2;
    QListWidget* m_lst;
};

void CustomDialog::onSelChangedBox(int iSel)
{
    qDebug() << "clear focus of m_box";
    m_lst->setFocus();
}

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

    CustomDialog dlg;
    dlg.setFixedSize(500, 500);
    dlg.show();

    return a.exec();
}

#include "main.moc"

解决方案 #

问题根源在于QComboBox的编辑框（QLineEdit子类）在不同操作路径下的焦点与光标状态未被统一控制，以下是针对性修复方案：

1. 为编辑框安装事件过滤器 #

在CustomDialog构造函数中，给每个QComboBox的编辑框添加事件过滤器，精准控制光标显示时机：

// 针对单控件场景
m_box->lineEdit()->installEventFilter(this);

// 针对多控件场景
m_box1->lineEdit()->installEventFilter(this);
m_box2->lineEdit()->installEventFilter(this);

2. 实现事件过滤逻辑 #

在CustomDialog类中重写eventFilter函数，根据事件类型控制光标：

protected:
    bool eventFilter(QObject* watched, QEvent* event) override
    {
        QLineEdit* edit = qobject_cast<QLineEdit*>(watched);
        if (edit && (watched == m_box->lineEdit() || watched == m_box1->lineEdit() || watched == m_box2->lineEdit())) {
            switch (event->type()) {
                case QEvent::MouseButtonPress:
                    // 鼠标点击输入区域时显示光标
                    edit->setCursor(Qt::IBeamCursor);
                    break;
                case QEvent::FocusOut:
                    // 失去焦点时强制隐藏光标
                    edit->setCursor(Qt::BlankCursor);
                    break;
                case QEvent::FocusIn:
                    // 非鼠标触发的焦点进入（如选择项后）隐藏光标
                    if (QApplication::mouseButtons() == Qt::NoButton) {
                        edit->setCursor(Qt::BlankCursor);
                    }
                    break;
                default:
                    break;
            }
        }
        return QDialog::eventFilter(watched, event);
    }

3. 修正选中项后的光标状态 #

在选中项的槽函数中，明确隐藏当前ComboBox编辑框的光标：

void CustomDialog::onSelChangedBox(int iSel)
{
    qDebug() << "clear focus of m_box";
    QComboBox* senderBox = qobject_cast<QComboBox*>(sender());
    if (senderBox) {
        senderBox->lineEdit()->setCursor(Qt::BlankCursor);
    }
    m_lst->setFocus();
}

4. 监听QCompleter选择事件 #

针对搜索匹配后点击选择的场景，监听QCompleter的activated信号，确保选择后隐藏光标：

// 在构造函数中添加连接
connect(completer1, QOverload<const QString&>::of(&QCompleter::activated), [this](const QString&){
    m_box1->lineEdit()->setCursor(Qt::BlankCursor);
});
connect(completer2, QOverload<const QString&>::of(&QCompleter::activated), [this](const QString&){
    m_box2->lineEdit()->setCursor(Qt::BlankCursor);
});

最终效果 #

• 三种操作方式下，选中候选项后m_box输入框均无光标显示
• 仅鼠标点击m_box输入区域时，才会显示编辑光标
• 切换多个QComboBox时，原控件光标自动隐藏，无双向标异常

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