如何隐藏QListWidget滚动条，改用QScrollArea的滚动条？

核心操作步骤 #

• 关闭QListWidget自带的垂直/水平滚动条
• 配置QListWidget的尺寸策略，让其高度随列表内容自动适配
• 将QListWidget放入QScrollArea，并开启滚动区域的控件自适应属性

完整代码示例 #

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QScrollArea, 
                             QListWidget, QListWidgetItem, QVBoxLayout, QWidget)
from PyQt5.QtCore import Qt

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("滚动条替代示例")
        self.setGeometry(100, 100, 300, 400)

        # 创建外层滚动区域
        scroll_area = QScrollArea()
        scroll_area.setWidgetResizable(True)  # 关键：允许内部控件自动调整尺寸

        # 创建容器承载QListWidget（避免滚动区域直接嵌套列表的布局问题）
        container = QWidget()
        layout = QVBoxLayout(container)
        layout.setContentsMargins(0, 0, 0, 0)  # 清除边距防止多余空白

        # 创建QListWidget并隐藏自带滚动条
        list_widget = QListWidget()
        list_widget.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
        list_widget.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
        # 设置尺寸策略：宽度匹配父容器，高度随内容扩展
        list_widget.setSizePolicy(list_widget.sizePolicy().horizontalPolicy(), 
                                  Qt.SizePolicy.MinimumExpanding)

        # 填充测试列表项
        for i in range(50):
            list_widget.addItem(QListWidgetItem(f"列表项 {i+1}"))

        # 将列表加入容器布局，再把容器设为滚动区域的控件
        layout.addWidget(list_widget)
        scroll_area.setWidget(container)

        self.setCentralWidget(scroll_area)

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

关键代码说明 #

• list_widget.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)：直接关闭QListWidget自带的垂直滚动条，水平滚动条可通过相同方式关闭。
• scroll_area.setWidgetResizable(True)：让QScrollArea自动识别内部控件的实际尺寸，确保滚动条能根据内容高度正常工作。
• list_widget.setSizePolicy(...)：设置列表的高度策略为MinimumExpanding，使其高度随列表项数量自动扩展，这样滚动区域才能计算出正确的滚动范围。

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