PyQt5 QTreeWidget拖拽操作时如何实现鼠标滚轮滚动浏览功能

默认拖拽状态下QTreeWidget的滚轮事件会被全局拖拽管理器拦截，以下是无需修改现有拖拽逻辑、代码量极小的实现方案：

实现步骤 #

• 首先确认你已完成QTreeWidget的基础拖拽配置（已实现拖拽互传可跳过该步）：

# PyQt/PySide 示例配置
tree_widget.setDragEnabled(True)
tree_widget.setAcceptDrops(True)
tree_widget.setDropIndicatorShown(True)

• 给所在窗口/控件实现通用事件过滤器，处理拖拽状态下的滚轮事件：

def eventFilter(self, obj, event):
    # 仅匹配QTreeWidget的滚轮事件
    if isinstance(obj, QTreeWidget) and event.type() == QEvent.Wheel:
        # 校验当前处于左键拖拽激活状态
        if QApplication.mouseButtons() & Qt.LeftButton and QDrag.drag():
            delta = event.angleDelta().y()
            scroll_bar = obj.verticalScrollBar()
            # 根据滚轮步长调整滚动条位置
            scroll_bar.setValue(scroll_bar.value() - delta // 120 * scroll_bar.singleStep())
            return True
    return super().eventFilter(obj, event)

• 给两个QTreeWidget都安装上述事件过滤器：

self.tree_widget1.installEventFilter(self)
self.tree_widget2.installEventFilter(self)

补充说明 #

注意：QTreeWidget自带的autoScroll属性仅实现拖拽到控件边缘时自动滚动，无法支持主动鼠标滚轮控制滚动，不需要额外开启该属性

• C++ Qt 版本逻辑完全一致，对应语法调整即可：

bool YourClass::eventFilter(QObject *obj, QEvent *event)
{
    QTreeWidget *tree = qobject_cast<QTreeWidget*>(obj);
    if (tree && event->type() == QEvent::Wheel) {
        QWheelEvent *wheelEvent = static_cast<QWheelEvent*>(event);
        if (QApplication::mouseButtons() & Qt::LeftButton && QDrag::drag()) {
            int delta = wheelEvent->angleDelta().y();
            QScrollBar *scrollBar = tree->verticalScrollBar();
            scrollBar->setValue(scrollBar->value() - delta / 120 * scrollBar->singleStep());
            return true;
        }
    }
    return QObject::eventFilter(obj, event);
}

• 如果需要支持横向滚动，同理处理horizontalScrollBar即可
• 该方案完全不侵入你已有的拖拽互传逻辑，适配Qt5、Qt6全版本

内容的提问来源于stack exchange，提问作者СергейП