如何实现Qt控件键盘分页滚动并在内容边界自动停止

直接调用self.widget.scroll()做平移是问题的核心原因：这个方法是对控件内容做无校验的像素偏移，完全不会感知外层QScrollArea的可视区域范围、内容总高度，自然不会在内容顶/底边界自动停止，最终出现越界滚动的问题。

QScrollArea内置了垂直滚动条实例，所有滚动操作直接对接这个滚动条即可——滚动条本身自带范围校验，设置的滚动值超出[0, 最大值]区间时，会自动钳制到边界位置，从根本上避免越界。

替换keyPressEvent中的滚动逻辑即可：

def keyPressEvent(self, event):
    # 保留其他原有按键判断逻辑
    v_bar = self.scroll.verticalScrollBar()
    page_height = self.height()

    if event.text() == c['key_next_page']:
        # 下翻一页：滚动值累加单页高度
        v_bar.setValue(v_bar.value() + page_height)
    elif event.text() == c['key_prev_page']:
        # 上翻一页：滚动值扣减单页高度
        v_bar.setValue(v_bar.value() - page_height)
    
    # 必须调用父类实现，避免其他默认按键交互失效
    super().keyPressEvent(event)

• 如果要完全对齐Qt原生的翻页行为，不需要手动计算单页高度，直接调用滚动条内置的步进动作即可：

  # 注意根据自己的导入版本替换PySide2/PySide6引用
  from PySide6.QtWidgets import QAbstractSlider
  # 下翻一页
  v_bar.triggerAction(QAbstractSlider.SliderPageStepAdd)
  # 上翻一页
  v_bar.triggerAction(QAbstractSlider.SliderPageStepSub)
  

  这种方式会自动读取滚动条配置的pageStep属性做偏移，在窗口缩放、DPI变化的场景下适配性更好。
• 你之前通过setVerticalScrollBarPolicy隐藏了滚动条，不会影响滚动条的逻辑运行，哪怕滚动条不可见，它的值范围、步进规则都是正常生效的，不需要额外做兼容处理。
• 不要直接操作内部self.widget的位移，所有滚动逻辑都交给QScrollArea的滚动条管控，能避免内容渲染错位、滚动位置不同步的问题。

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