PyQT6中如何让动态添加的部件始终附着在QVBoxLayout顶部？

我在QScrollArea内放置了一个包含QVBoxLayout的QWidget，初始化代码如下：

self.vbox = QVBoxLayout()
self.widget = QWidget()
self.widget.setLayout(self.vbox)

self.scroll = QScrollArea()
self.scroll.setWidget(self.widget)

初始时我在滚动区域内添加了四个按钮，通过addStretch()让按钮保持在顶部：

# ...添加四个按钮的方法...
self.vbox.addStretch()

但程序运行后再添加四个按钮时，我执行了如下操作：

# ...添加四个按钮的方法...
self.vbox.addStretch()
# ...添加另外四个按钮的方法...

此时控件布局出现异常，新增的按钮无法附着在顶部。

问题原因 #

第一次调用addStretch()会在布局末尾添加一个占据所有剩余空间的拉伸项，后续新增的按钮会被插入到这个拉伸项之后，自然会被挤到滚动区域的底部。

解决方法 #

方法一：动态管理拉伸项

先移除布局中已有的拉伸项，添加新按钮后再重新添加拉伸项：

# 倒序遍历布局，找到并移除最后一个拉伸项
for i in reversed(range(self.vbox.count())):
    item = self.vbox.itemAt(i)
    if item and item.spacerItem():
        self.vbox.removeItem(item)
        break

# 添加新的四个按钮
# button = QPushButton("新按钮")
# self.vbox.addWidget(button)
# ... 重复添加四个按钮 ...

# 重新添加拉伸项，让所有按钮保持在顶部
self.vbox.addStretch()

方法二：设置布局全局对齐

初始化布局时直接设置内容顶部对齐，无需依赖addStretch()：

# 初始化布局时设置顶部对齐
self.vbox = QVBoxLayout()
self.vbox.setAlignment(Qt.AlignTop)  # 关键配置
self.widget = QWidget()
self.widget.setLayout(self.vbox)

self.scroll = QScrollArea()
self.scroll.setWidget(self.widget)

# 后续添加按钮直接调用addWidget即可，无需额外操作
# ... 添加初始四个按钮 ...
# ... 后续添加另外四个按钮 ...

两种方法对比：方法一适合需要灵活控制拉伸位置的场景，方法二更简洁，通过布局属性直接实现顶部附着效果。

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