Qt 5.15.2中如何禁止用户展开QTreeWidgetItem？

针对你遇到的setDisabled()仅置灰但无法阻止展开、setFlags(0)无效的问题，这里提供两种可靠的实现方式：

方案1：事件过滤器拦截用户操作 #

给QTreeWidget安装事件过滤器，直接拦截触发展开/收起的鼠标点击和键盘操作：

bool CustomTreeWidget::eventFilter(QObject *watched, QEvent *event)
{
    if (watched == this) {
        // 拦截鼠标点击展开箭头
        if (event->type() == QEvent::MouseButtonPress) {
            QMouseEvent *mouseEvent = static_cast<QMouseEvent*>(event);
            QModelIndex hitIndex = indexAt(mouseEvent->pos());
            if (hitIndex.isValid()) {
                // 展开箭头的区域宽度等于树的缩进值
                QRect indicatorArea = visualRect(hitIndex);
                indicatorArea.setWidth(indentation());
                if (indicatorArea.contains(mouseEvent->pos())) {
                    QTreeWidgetItem *targetItem = itemFromIndex(hitIndex);
                    // 替换成你的目标项判断逻辑，比如通过item的自定义数据或指针匹配
                    if (targetItem == yourRestrictedItem) {
                        return true; // 吃掉事件，阻止展开/收起
                    }
                }
            }
        }
        // 拦截键盘触发的展开（回车、左右箭头）
        else if (event->type() == QEvent::KeyPress) {
            QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
            Qt::Key key = static_cast<Qt::Key>(keyEvent->key());
            if (key == Qt::Key_Return || key == Qt::Key_Enter ||
                key == Qt::Key_Right || key == Qt::Key_Left) {
                QModelIndex currentIdx = currentIndex();
                if (currentIdx.isValid()) {
                    QTreeWidgetItem *targetItem = itemFromIndex(currentIdx);
                    if (targetItem == yourRestrictedItem) {
                        return true; // 拦截按键
                    }
                }
            }
        }
    }
    return QTreeWidget::eventFilter(watched, event);
}

使用时，在你的树部件构造函数中添加：

installEventFilter(this);

注意要把CustomTreeWidget换成你实际的QTreeWidget子类名称。

方案2：重写展开/收起方法（更彻底） #

如果需要覆盖所有触发展开的场景（包括代码调用），可以直接重写QTreeWidget的expandItem和collapseItem方法：

void CustomTreeWidget::expandItem(QTreeWidgetItem *item)
{
    // 仅允许非限制项展开
    if (item != yourRestrictedItem) {
        QTreeWidget::expandItem(item);
    }
}

void CustomTreeWidget::collapseItem(QTreeWidgetItem *item)
{
    // 仅允许非限制项收起
    if (item != yourRestrictedItem) {
        QTreeWidget::collapseItem(item);
    }
}

优化建议 #

• 动态控制：如果需要在不同场景切换限制状态，可以给目标项设置自定义数据标记，比如：

  // 标记为不可展开
  yourRestrictedItem->setData(0, Qt::UserRole, QVariant(true));
  

  然后在判断逻辑中读取这个值：

  if (targetItem->data(0, Qt::UserRole).toBool()) { ... }
  

• 视觉反馈：配合setDisabled(true)让项置灰，用户能直观感知到该项不可操作。

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