如何避免非滚动Qt布局中控件过度排布挤压重叠

诸如QVBoxLayout这类Qt填充式布局，可在内部承载按钮等控件，默认情况下控件会沿垂直方向排布，效果如下图所示：

当这类布局中放置的控件数量过多时，由于布局默认未集成滚动能力，控件会被持续压缩，最终出现互相重叠的问题，效果如下图所示：

Qt 原生的 QVBoxLayout/QHBoxLayout 这类盒式布局没有提供开箱即用的配置项直接实现「超出可视区域控件隐藏、动态适配窗口尺寸」的效果，需要通过自定义布局类完成逻辑扩展，具体对应两个问题的实现逻辑如下：

针对「超出可视区域控件不参与排布、不显示」的实现 #

核心逻辑是在布局排布控件的阶段，提前计算当前布局的可用空间，逐控件累计占用尺寸，当累计尺寸超出可用范围时，直接将后续控件设置为隐藏状态，不分配显示位置，同时禁止布局将控件压缩到其推荐尺寸以下，从根源避免控件重叠、侵占边距/间距的问题：

• 可用空间计算规则：布局总高度 - 布局上下边距 - 已排布控件之间的累计间距
• 控件尺寸规则：所有控件以自身sizeHint()返回的推荐尺寸作为最小允许尺寸，布局不做压缩拉伸，保证控件完整显示
• 显隐判定规则：每排布一个控件前，先计算加入该控件后累计占用的总尺寸，如果超过可用空间，该控件及后续所有控件直接隐藏，不参与本次排布

针对「窗口尺寸调整动态适配」的实现 #

布局类的setGeometry方法会在窗口尺寸变化、布局需要重新计算控件位置时自动触发，只需要把上述空间计算、控件显隐判断的逻辑写在这个方法里，就能自动响应窗口拉伸/缩小的场景：空间充足时自动显示之前隐藏的控件，空间不足时自动隐藏显示不下的控件。
另外针对浮动窗口无限扩张超出屏幕的问题，只需要给布局所在的顶层窗口设置最大高度为当前屏幕的可用工作区高度即可，不需要额外处理。

可运行示例代码（PyQt5） #

from PyQt5 import QtCore, QtWidgets

class AutoHideVBoxLayout(QtWidgets.QVBoxLayout):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 可自定义布局间距、边距
        self.setSpacing(10)
        self.setContentsMargins(10, 10, 10, 10)

    def setGeometry(self, rect):
        super().setGeometry(rect)
        # 计算当前布局可用的总高度
        margin = self.contentsMargins()
        available_height = rect.height() - margin.top() - margin.bottom()
        used_height = 0
        item_spacing = self.spacing()
        total_count = self.count()

        for idx in range(total_count):
            layout_item = self.itemAt(idx)
            target_widget = layout_item.widget()
            if not target_widget:
                continue
            # 取控件推荐高度，不做压缩
            widget_height = target_widget.sizeHint().height()
            # 计算放置当前控件需要的额外高度，第一个控件不需要前置间距
            required_total = used_height + widget_height + (item_spacing if idx > 0 else 0)
            
            if required_total > available_height:
                # 超出可用范围，隐藏控件
                target_widget.hide()
            else:
                # 空间足够，设置控件位置尺寸并显示
                target_widget.setGeometry(
                    margin.left(),
                    margin.top() + used_height + (item_spacing if idx > 0 else 0),
                    rect.width() - margin.left() - margin.right(),
                    widget_height
                )
                target_widget.show()
                used_height = required_total

    def addWidget(self, widget):
        # 强制控件最小高度等于推荐高度，禁止布局压缩控件导致重叠
        widget.setMinimumHeight(widget.sizeHint().height())
        super().addWidget(widget)

if __name__ == "__main__":
    app = QtWidgets.QApplication([])
    window = QtWidgets.QWidget()
    # 限制窗口最大高度为屏幕可用高度，避免浮动状态下窗口无限扩张超出屏幕
    screen_available = app.primaryScreen().availableGeometry()
    window.setMaximumHeight(screen_available.height())
    # 使用自定义布局
    layout = AutoHideVBoxLayout(window)
    # 测试添加40个按钮
    for i in range(40):
        layout.addWidget(QtWidgets.QPushButton(str(i + 1)))
    window.show()
    app.exec_()

效果说明 #

• 窗口平铺状态下：自动根据当前窗口高度计算可容纳的控件数量，超出的控件直接隐藏，不会出现压缩重叠、侵占边距/间距的问题
• 窗口浮动状态下：窗口不会扩张超出屏幕范围，拉伸窗口高度时自动逐行显示之前隐藏的控件，缩小窗口时自动隐藏底部显示不下的控件
• 所有排布逻辑严格遵守设置的布局边距、控件间距规则，符合“控件排布过量”的判定标准，不会出现控件侵占预留间距、布局边距区域的问题

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