PyQt5开发如何避免窗口缩小时布局内控件收缩重叠

问题原因 #

这是QScrollArea的典型用法错误：QScrollArea本身不支持直接挂载布局承载子控件。直接给QScrollArea设置QVBoxLayout的写法，会导致滚动区域无法识别内部内容的尺寸边界，窗口缩小时不会触发滚动条逻辑，只会强制压缩内部控件高度，最终出现控件重叠。

正确配置步骤 #

• 新建一个通用QWidget实例作为滚动区域的内容承载容器，不要直接把QVBoxLayout绑定到QScrollArea上
• 将需要使用的QVBoxLayout设置到这个新建的容器QWidget上，再把所有QGroupBox逐个添加到这个垂直布局中
• 调用QScrollArea的setWidget()方法，将配置好布局的容器控件传入，作为滚动区域的承载内容
• 给QScrollArea开启setWidgetResizable(True)属性，保证内部容器宽度会自动适配滚动区域的可视宽度，不会出现横向滚动条错位
• （可选）在QVBoxLayout的末尾调用addStretch()添加伸缩项，让所有QGroupBox保持靠上排列，不会被拉伸分散布局；同时给每个QGroupBox设置合理的最小高度，避免被异常压缩

修正后的示例代码 #

# 初始化滚动区域
scroll_area = QScrollArea()
# 创建内容承载容器
content_container = QWidget()
# 给容器绑定垂直布局
v_layout = QVBoxLayout(content_container)
# 逐个添加分组框
v_layout.addWidget(QGroupBox1)
v_layout.addWidget(QGroupBox2)
v_layout.addWidget(QGroupBox3)
# 底部添加伸缩项
v_layout.addStretch()
# 将容器绑定到滚动区域
scroll_area.setWidget(content_container)
# 开启宽度自适应
scroll_area.setWidgetResizable(True)

配置完成后，当窗口缩小、滚动区域可视高度小于内部所有控件总高度时，会自动弹出垂直滚动条，不会再强制压缩内部QGroupBox的高度，也就不会出现控件收缩、重叠的问题。

内容的提问来源于stack exchange，提问作者Yong Hwan Kim