QGraphicsView滚轮事件中缩放与滚动功能冲突问题求助

我明白你遇到的麻烦了——在自定义wheelEvent时同时加缩放和滚动代码，结果滚动失效还出现偏移，这其实是因为缩放的坐标变换和滚动的视图调整没有协同处理，而且默认的滚轮事件逻辑被覆盖后没正确衔接。

问题根源分析 #

1. 缩放的中心点错误：你当前的scale()方法是基于视图的左上角原点进行缩放，而非鼠标所在位置，多次缩放后自然会出现视图偏移。
2. 滚动与缩放的坐标冲突：直接调用scrollContentsBy是在视图的像素坐标系下操作，但缩放已经改变了视图到场景的变换关系，两者的坐标空间不匹配，导致滚动失效。
3. 未正确处理事件传递：自定义wheelEvent后，默认的滚动逻辑被覆盖，需要手动协调缩放和滚动的逻辑顺序。

解决方案代码 #

下面是修改后的完整代码，我会标注关键改进点：

from PySide2.QtWidgets import *
from PySide2.QtGui import *
from PySide2.QtCore import *
import sys

class Scene(QGraphicsScene):
    def __init__(self, _scene_width, _scene_height):
        super(Scene, self).__init__()
        self.setSceneRect(0, 0, _scene_width, _scene_height)
        map_center = _scene_width / 2
        te = QTextEdit()
        te.insertPlainText("Test Text")
        te.setGeometry(map_center, map_center, 100, 100)
        self.addWidget(te)

class View(QGraphicsView):
    def __init__(self, _scene_width, _scene_height):
        super(View, self).__init__()
        self.scale_factor = 1.0
        self.scene_width = _scene_width
        self.scene_height = _scene_height
        scene = Scene(_scene_width, _scene_height)
        self.setScene(scene)
        # 开启抗锯齿让缩放更平滑
        self.setRenderHint(QPainter.Antialiasing)
        self.showMaximized()

    def wheelEvent(self, event):
        if self.underMouse():
            # --- 1. 以鼠标位置为中心进行缩放 ---
            # 获取鼠标在视图中的位置
            mouse_pos = event.pos()
            # 转换为场景坐标（缩放前的场景位置）
            scene_pos = self.mapToScene(mouse_pos)
            
            # 执行缩放
            zoom_factor = 1.2 if event.angleDelta().y() > 0 else 1/1.2
            self.scale_factor *= zoom_factor
            self.scale(zoom_factor, zoom_factor)
            
            # 计算缩放后，原来的鼠标场景位置对应的视图坐标
            new_mouse_view_pos = self.mapFromScene(scene_pos)
            # 调整视图偏移，让鼠标位置保持在原地（解决缩放偏移）
            offset = new_mouse_view_pos - mouse_pos
            self.viewport().scroll(offset.x(), offset.y())
            
            # --- 2. 处理滚动（适配缩放因子） ---
            # 滚轮每一格的单位是120，转换为滚动步数
            scroll_delta = event.angleDelta().y() / 120
            # 滚动步长除以缩放因子，保证缩放前后滚动视觉效果一致
            scroll_step = 50 / self.scale_factor
            # 水平滚动（保持你原来的x轴滚动需求）
            self.horizontalScrollBar().setValue(self.horizontalScrollBar().value() - scroll_delta * scroll_step)
            # 如果需要垂直滚动，替换成下面这行
            # self.verticalScrollBar().setValue(self.verticalScrollBar().value() - scroll_delta * scroll_step)
            
            # 标记事件已处理，避免传递给父类
            event.accept()
        else:
            # 鼠标不在视图上时，使用默认滚轮行为
            super().wheelEvent(event)

def main():
    app = QApplication(sys.argv)
    view = View(1000000, 1000000)
    view.show()
    sys.exit(app.exec_())

if __name__ == '__main__':
    main()

关键改进说明 #

• 鼠标中心缩放：通过先记录鼠标的场景坐标，缩放后调整视图偏移，保证缩放时鼠标位置始终对应场景中的同一位置，彻底解决偏移问题。
• 适配缩放的滚动：滚动步长除以当前缩放因子，确保无论缩放多少倍，滚动的视觉效果一致；使用滚动条的setValue方法，比scrollContentsBy更适配QGraphicsView的坐标变换逻辑。
• 事件处理隔离：鼠标在视图上时自定义处理，不在时调用父类默认行为，保持其他场景下的正常逻辑。

这样修改后，你就能同时实现平滑的鼠标中心缩放和正常的滚动功能了，不会再出现冲突或偏移问题。

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