Qt/PySide6：运行时向QScrollArea添加部件不显示的解决方法

问题核心：当setWidgetResizable(False)时，QScrollArea不会自动调整内部子部件的尺寸。初始创建的outputWidget没有足够空间容纳新增的QLabel，即便布局已添加控件，子部件尺寸未更新导致内容无法显示。

解决方案 #

每次添加QLabel后，手动触发内部部件的尺寸调整，让它根据布局重新计算合适大小。需做两处修改：

1. 将内部的outputWidget设为类实例变量，方便在add方法中调用其方法
2. 添加QLabel后，调用outputWidget.adjustSize()更新部件尺寸

修改后的代码 #

from PySide6.QtWidgets import *

class MainWindow(QMainWindow):
    def __init__(self):
        QMainWindow.__init__(self)

        button = QPushButton('Add')
        button.clicked.connect(self.add)

        centralWidget = QWidget()
        centralWidget.setLayout(QVBoxLayout())
        self.setCentralWidget(centralWidget)
        centralWidget.layout().addWidget(button)

        self.outputLayout = QVBoxLayout()
        # 将outputWidget设为实例变量
        self.outputWidget = QWidget()
        self.outputWidget.setLayout(self.outputLayout)
        self.scrollArea = QScrollArea()
        self.scrollArea.setWidget(self.outputWidget)
        centralWidget.layout().addWidget(self.scrollArea)

    def add(self):
        label = QLabel('test')
        self.outputLayout.addWidget(label)
        # 调整内部部件尺寸以适应新增内容
        self.outputWidget.adjustSize()

if __name__ == '__main__':
    app = QApplication()
    mainWindow = MainWindow()
    mainWindow.show()
    app.exec()

原理说明 #

• adjustSize()会让QWidget根据其布局内的子部件重新计算并设置自身最佳尺寸，QScrollArea就能识别到内部内容的尺寸变化，从而显示新增的QLabel
• 这种方式不会像setWidgetResizable(True)那样强制让内部部件填充整个ScrollArea，能保留部件原本的尺寸布局

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