Qt：仅允许双击TreeView项时选中该项

我之前也遇到过类似的需求，你的思路方向是对的，但直接在clicked槽里清除选中会有延迟和遗漏（比如右键点击的情况），因为默认选中行为是在事件触发的早期阶段就完成了，槽函数是后续才执行的。下面给你一个更可靠的解决方案，用事件过滤器从源头拦截不需要的选择触发：

步骤1：给TreeView安装事件过滤器 #

首先在你的窗口类构造函数里，给TreeView安装事件过滤器，这样我们就能拦截它的鼠标事件：

MyApp::MyApp(QWidget *parent) : QMainWindow(parent), ui(new Ui::MyApp)
{
    ui->setupUi(this);
    // 安装事件过滤器
    ui->treeViewFiles->installEventFilter(this);
    // 设置选择模式为单选（可选，根据你的需求调整）
    ui->treeViewFiles->setSelectionMode(QAbstractItemView::SingleSelection);
}

步骤2：重写事件过滤函数 #

在你的类声明里添加eventFilter的重写声明，然后实现它，拦截左键单击、右键的所有按键事件，只允许双击事件触发选择：

类声明修改： #

class MyApp : public QMainWindow
{
    Q_OBJECT
public:
    explicit MyApp(QWidget *parent = nullptr);
    ~MyApp();

protected:
    // 添加事件过滤函数声明
    bool eventFilter(QObject *obj, QEvent *event) override;

private slots:
    void on_treeViewFiles_doubleClicked(const QModelIndex &fileidx);

private:
    Ui::MyApp *ui;
};

事件过滤函数实现： #

bool MyApp::eventFilter(QObject *obj, QEvent *event)
{
    if (obj == ui->treeViewFiles) {
        // 处理鼠标按键事件
        if (event->type() == QEvent::MouseButtonPress || event->type() == QEvent::MouseButtonRelease) {
            QMouseEvent *mouseEvent = static_cast<QMouseEvent*>(event);
            
            // 拦截右键点击（如果需要右键菜单，这里可以手动弹出）
            if (mouseEvent->button() == Qt::RightButton) {
                // 可选：手动弹出右键菜单
                if (event->type() == QEvent::MouseButtonPress) {
                    QMenu menu;
                    menu.addAction("打开");
                    menu.addAction("删除");
                    menu.exec(ui->treeViewFiles->mapToGlobal(mouseEvent->pos()));
                }
                return true; // 阻止TreeView处理右键事件，避免选中项
            }
            
            // 拦截左键单击（非双击）
            if (mouseEvent->button() == Qt::LeftButton && event->type() != QEvent::MouseButtonDblClick) {
                return true; // 阻止TreeView处理左键单击，避免选中项
            }
        }
    }
    // 其他事件交给父类处理
    return QMainWindow::eventFilter(obj, event);
}

步骤3：完善双击槽函数 #

在双击事件里，我们可以手动确保选中项（虽然默认双击会触发选中，但手动设置更稳妥），然后添加你的业务逻辑：

void MyApp::on_treeViewFiles_doubleClicked(const QModelIndex &fileidx)
{
    // 手动选中当前双击的项，确保高亮显示
    ui->treeViewFiles->selectionModel()->select(
        fileidx, 
        QItemSelectionModel::ClearAndSelect | QItemSelectionModel::Rows
    );
    
    // 这里添加你的双击处理逻辑，比如打开文件、显示详情等
    qDebug() << "双击了：" << fileidx.data().toString();
}

为什么之前的方法没效果？ #

你之前在clicked槽里调用clearSelection()，是因为TreeView的默认选中行为在clicked信号触发之前就已经完成了，所以会出现“先选中再清除”的闪烁，而且右键点击触发的选择（某些场景下右键也会选中）根本不会触发clicked信号，所以无法拦截。事件过滤器是在事件到达TreeView之前就处理，从源头阻止了不需要的选中操作，效果更稳定。

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