PySide2中如何设置QScroller仅垂直滚动 修复拖拽失效问题

这个问题是两个配置逻辑共同导致的：

• 你转换PDF生成的图片宽度设置为窗口宽度的1.2倍，直接造成滚动区域内部内容宽度超出视口，存在横向可滚动空间。虽然你通过setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)隐藏了水平滚动条，但QScroller仍然能识别到横向滚动范围，不会自动忽略横向位移。
• QScroller默认带轴向锁定逻辑：同一次拖拽操作中，会根据初始位移的方向判定本次滚动的目标轴向，一旦判定为横向滚动，就会全程忽略同一次拖拽中的垂直位移。因为你隐藏了水平滚动条，横向滚动没有任何视觉反馈，最终表现为拖拽操作失效，必须松手重新拖拽才能恢复响应。

按以下三点修改即可解决问题：

• 修正图片缩放逻辑，从根源消除横向溢出。把PDF转换时的宽度参数从width*1.2改为和窗口宽度一致的width，保证内部图片宽度不超过滚动区域视口宽度，让横向滚动范围始终为0。如果需要保留图片更高的清晰度，也可以在加载QPixmap后做等比缩放，将宽度适配到视口宽度即可。
• 调整QScroller轴向判定阈值。在现有Scroller属性配置中添加AxisLockThreshold的设置，将值设为0.1，降低横向锁定的触发敏感度，只有拖拽位移几乎完全水平时才会判定为横向滚动。
• 强制锁死水平滚动位置。调用setSnapPositionsX([0])将QScroller的水平停靠位置强制锁在0点，所有横向拖拽位移会被自动忽略，完全不会触发横向轴向锁定。

注意：如果后续需要动态调整窗口大小，记得在窗口resize事件中重新调整图片宽度，保证始终适配视口，避免重新出现横向溢出。

另外原代码中创建QLabel时父控件传入了主窗口而非滚动区域内部容器，会导致控件层级异常，一并修正即可。修改后的完整代码如下：

import sys
from PySide2.QtWidgets import *
from PySide2 import QtCore
from PySide2.QtCore import Qt
from PySide2.QtGui import QPixmap
from pdf2image import convert_from_path
   
class MainWindow(QMainWindow):

    def __init__(self, parent=None):
        super(MainWindow, self).__init__(parent)

        self.scroll_area = QScrollArea()
        self.main_widget = QWidget()
        self.main_layout = QVBoxLayout()
        self.main_layout.setAlignment(Qt.AlignCenter)
        self.main_widget.setLayout(self.main_layout)
        self.layout = QVBoxLayout()
        self.layout.setAlignment(Qt.AlignCenter)
        self.setWindowFlag(QtCore.Qt.FramelessWindowHint)
        self.showFullScreen()
        self.inner = QFrame()
        self.inner.setLayout(self.layout)
        self.scroll_area.setWidget(self.inner)
        self.main_layout.addWidget(self.scroll_area)
        self.setCentralWidget(self.main_widget)
        width = self.size().width()
        # 修正图片宽度适配窗口，移除*1.2的超宽设置
        pages = convert_from_path('test_document1.pdf', 500, 'test_document1', poppler_path="poppler/bin", size=width)
        for index, page in enumerate(pages):
            page.save('test_document1/' + str(index) + '.jpg', 'JPEG')
            # 修正QLabel父控件为内部容器
            label = QLabel(self.inner)
            pixmap = QPixmap('test_document1/' + str(index) + '.jpg')
            label.setPixmap(pixmap)
            self.layout.addWidget(label)
        # Scroll Area Properties
        self.scroll_area.horizontalScrollBar().setEnabled(False)
        self.scroll_area.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOn)
        self.scroll_area.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
        self.scroll_area.setWidgetResizable(True)
        self.scroll_area.setFrameShape(QFrame.NoFrame)
        self.scroller = QScroller.scroller(self.scroll_area.viewport())
        self.scroller.grabGesture(self.scroll_area.viewport(), QScroller.LeftMouseButtonGesture)
        props = self.scroller.scrollerProperties()
        props.setScrollMetric(QScrollerProperties.FrameRate, QScrollerProperties.Fps60)
        props.setScrollMetric(QScrollerProperties.DecelerationFactor, 1)
        props.setScrollMetric(QScrollerProperties.DragVelocitySmoothingFactor, 0.4)
        props.setScrollMetric(QScrollerProperties.OvershootScrollTime, 0.4)
        props.setScrollMetric(QScrollerProperties.MaximumClickThroughVelocity, 0)
        props.setScrollMetric(QScrollerProperties.MinimumVelocity, 0.15)
        props.setScrollMetric(QScrollerProperties.MaximumVelocity, 0.6)
        props.setScrollMetric(QScrollerProperties.AcceleratingFlickMaximumTime, 0.3)
        # 新增轴向阈值配置，降低横向锁定敏感度
        props.setScrollMetric(QScrollerProperties.AxisLockThreshold, 0.1)
        self.scroller.setScrollerProperties(props)
        # 强制锁死水平滚动位置，彻底忽略横向位移
        self.scroller.setSnapPositionsX([0])


if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MainWindow()
    sys.exit(app.exec_())

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