PyQt：实现QGroupBox随内部QTreeWidget展开折叠自动调大小

1. 实现自适应内容的QTreeWidget子类 #

重写QTreeWidget的sizeHint()方法，确保返回尺寸能完整容纳所有展开节点（不含滚动条）。通过递归计算所有可见项的总高度来实现：

from PyQt5.QtWidgets import QTreeWidget, QTreeWidgetItem
from PyQt5.QtCore import QSize

class AutoSizeTreeWidget(QTreeWidget):
    def sizeHint(self):
        # 计算总高度：表头高度 + 所有展开项高度
        total_height = self.header().height()
        for index in range(self.topLevelItemCount()):
            item = self.topLevelItem(index)
            total_height += self._calc_item_total_height(item)
        # 计算总宽度：列宽 + 边框 + 缩进
        total_width = self.sizeHintForColumn(0) + self.frameWidth() * 2 + self.indentation() * 2
        return QSize(total_width, total_height)
    
    def _calc_item_total_height(self, item):
        # 递归计算当前项及所有展开子项的高度总和
        height = self.rowHeight(self.indexFromItem(item))
        for child_idx in range(item.childCount()):
            child_item = item.child(child_idx)
            if child_item.isExpanded():
                height += self._calc_item_total_height(child_item)
        return height
    
    def trigger_size_update(self):
        # 通知父部件尺寸已变化
        self.updateGeometry()

2. 实现自动调整大小的QGroupBox子类 #

GroupBox内部必须使用布局管理TreeWidget，这样adjustSize()才能基于布局尺寸正确计算自身大小。同时监听TreeWidget的展开/折叠信号，触发尺寸调整：

from PyQt5.QtWidgets import QGroupBox, QVBoxLayout

class AutoAdjustGroupBox(QGroupBox):
    def __init__(self, title="", parent=None):
        super().__init__(title, parent)
        self.layout = QVBoxLayout(self)
        self.tree_widget = AutoSizeTreeWidget(self)
        self.layout.addWidget(self.tree_widget)
        
        # 绑定展开/折叠信号到尺寸调整槽函数
        self.tree_widget.itemExpanded.connect(self._adjust_groupbox_size)
        self.tree_widget.itemCollapsed.connect(self._adjust_groupbox_size)
        
        # 初始化时完成首次尺寸调整
        self._adjust_groupbox_size()
    
    def _adjust_groupbox_size(self):
        # 先更新TreeWidget的尺寸提示，再调整GroupBox大小
        self.tree_widget.trigger_size_update()
        self.adjustSize()

3. 主窗口中使用（无布局，支持拖拽） #

在主窗口中实现GroupBox的拖拽功能，确保窗口不限制GroupBox的大小：

from PyQt5.QtWidgets import QMainWindow, QApplication
from PyQt5.QtCore import Qt, QPoint

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Auto-Adjust GroupBox Demo")
        self.resize(800, 600)
        
        self.group_box = AutoAdjustGroupBox("可折叠树", self)
        self.group_box.setGeometry(100, 100, 200, 150)
        
        # 添加测试节点
        self._add_test_nodes()
        
        # 拖拽状态变量
        self._drag_start_pos = QPoint()
    
    def _add_test_nodes(self):
        root1 = QTreeWidgetItem(self.group_box.tree_widget, ["根节点1"])
        for i in range(3):
            child = QTreeWidgetItem(root1, [f"子节点1-{i}"])
            for j in range(2):
                QTreeWidgetItem(child, [f"孙节点1-{i}-{j}"])
        
        root2 = QTreeWidgetItem(self.group_box.tree_widget, ["根节点2"])
        for i in range(2):
            QTreeWidgetItem(root2, [f"子节点2-{i}"])
    
    # 实现拖拽逻辑
    def mousePressEvent(self, event):
        if event.button() == Qt.LeftButton and self.group_box.underMouse():
            self._drag_start_pos = event.globalPos() - self.group_box.frameGeometry().topLeft()
            event.accept()
    
    def mouseMoveEvent(self, event):
        if event.buttons() & Qt.LeftButton and not self._drag_start_pos.isNull():
            new_pos = event.globalPos() - self._drag_start_pos
            self.group_box.move(new_pos)
            event.accept()
    
    def mouseReleaseEvent(self, event):
        self._drag_start_pos = QPoint()
        event.accept()

if __name__ == "__main__":
    app = QApplication([])
    window = MainWindow()
    window.show()
    app.exec_()

关键原理说明 #

• TreeWidget尺寸计算：通过递归遍历所有展开项，确保sizeHint()准确反映当前内容的实际高度，而非依赖默认viewport尺寸。
• 信号驱动调整：监听节点展开/折叠信号，触发TreeWidget的尺寸更新和GroupBox的大小调整，保证用户手动操作时的实时响应。
• 布局的必要性：GroupBox内部使用布局后，adjustSize()会基于布局的sizeHint（即TreeWidget的尺寸提示）调整自身大小——没有布局的话，GroupBox无法感知内部控件的尺寸变化。

原方案失效原因 #

之前手动调用box.adjustSize()无效，核心问题是：

1. GroupBox内部未使用布局，无法获取TreeWidget的正确尺寸提示；
2. TreeWidget的尺寸变化未触发父部件的updateGeometry()，导致GroupBox不知道需要调整大小。

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