PyQt5如何实现按住Ctrl键禁用滚动、通过鼠标滚轮缩放QGraphicsView内容

问题根因 #

滚轮事件的传递顺序是从焦点控件开始向上冒泡，你当前将缩放逻辑写在了父容器step1的wheelEvent中，QGraphicsView会优先接收到滚轮事件，有滚动条时会先消费事件执行滚动操作，只有滚动到边界无法继续滚动时，未被消费的事件才会传递到父容器触发缩放逻辑。

修复方案 #

我们直接继承QGraphicsView自定义子类，在子类内部处理滚轮事件，按住Ctrl键时直接执行缩放逻辑并拦截事件，不触发默认滚动行为；未按住Ctrl时保留默认滚动逻辑即可。

完整可运行代码 #

from PyQt5.QtWidgets import QFileDialog, QLineEdit, QWidget, QPushButton, QApplication, QVBoxLayout, QGraphicsView, QGraphicsPixmapItem, QGraphicsScene
from PyQt5.QtCore import pyqtSignal, Qt
from pdf2image import convert_from_path
from PIL import ImageQt
import sys

# 自定义QGraphicsView子类
class CustomGraphicsView(QGraphicsView):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 设置滚动条显示策略
        self.setHorizontalScrollBarPolicy(Qt.ScrollBarAsNeeded)
        self.setVerticalScrollBarPolicy(Qt.ScrollBarAsNeeded)

    def wheelEvent(self, event):
        # 判断是否按住Ctrl键
        if event.modifiers() == Qt.ControlModifier:
            # 计算缩放系数
            scroll_step = event.angleDelta().y() / 120
            if scroll_step > 0:
                self.scale(1.05, 1.05)
            else:
                self.scale(0.95, 0.95)
            # 标记事件已被消费，不再向上传递也不执行默认滚动逻辑
            event.accept()
        else:
            # 未按住Ctrl时调用父类默认实现，正常响应滚动
            super().wheelEvent(event)

class step1(QWidget):
    changeViewSignal = pyqtSignal()
    
    def __init__(self, parent=None):
        super(step1, self).__init__(parent)
        self.name = QLineEdit(self)
        self.fileBtn = QPushButton("Select file", self)
        self.nextBtn = QPushButton("Next", self)
        # 替换为自定义的CustomGraphicsView
        self.graphicsView = CustomGraphicsView()

        self.layout = QVBoxLayout(self)
        self.layout.addWidget(self.name)
        self.layout.addWidget(self.fileBtn)
        self.layout.addWidget(self.nextBtn)
        self.layout.addWidget(self.graphicsView)

        self.fileBtn.clicked.connect(self.convert_file)

    def convert_file(self):
        fname = QFileDialog.getOpenFileName(self, 'Open File', 'c:\\', "PDF Files (*.pdf)")
        if len(fname[0]) > 0:
            pages = convert_from_path(fname[0])
            qimage = ImageQt.toqpixmap(pages[0])
            item = QGraphicsPixmapItem(qimage)
            scene = QGraphicsScene(self)
            scene.addItem(item)
            self.graphicsView.setScene(scene)
        
if __name__ == '__main__':
   app = QApplication(sys.argv)
   ex = step1()
   ex.show()
   sys.exit(app.exec_())

可选替代方案：事件过滤器 #

如果不想自定义子类，也可以给原生QGraphicsView安装事件过滤器，拦截滚轮事件处理：

1. 在step1的__init__里添加self.graphicsView.installEventFilter(self)
2. 重写step1的eventFilter方法：

def eventFilter(self, watched, event):
    if watched == self.graphicsView and event.type() == event.Wheel:
        if event.modifiers() == Qt.ControlModifier:
            scroll_step = event.angleDelta().y() / 120
            if scroll_step > 0:
                self.graphicsView.scale(1.05, 1.05)
            else:
                self.graphicsView.scale(0.95, 0.95)
            return True # 返回True表示事件已被消费，不再传递
    return super().eventFilter(watched, event)

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