取消停靠调整主窗口几何后，如何触发QTreeView更新？

这个问题我之前也碰到过，核心原因往往是QTreeView的列宽策略没设置对，或者布局没有让TreeView自动填充可用空间，导致主窗口尺寸变化后，TreeView没有跟着调整列宽来适配新的宽度。

先给你几个关键的解决步骤： #

1. 确保布局结构正确

首先检查你的CenterPane和QTreeView的布局：

• CenterPane应该作为主窗口的central widget，并且使用QVBoxLayout（或其他合适的布局）作为它的主布局
• QTreeView要添加到这个布局里，不要给TreeView设置固定宽度，让布局自动管理它的尺寸

比如初始化代码可以这样写：

# 主窗口初始化部分
self.CenterPane = QWidget()
self.setCentralWidget(self.CenterPane)
layout = QVBoxLayout(self.CenterPane)
layout.setContentsMargins(0, 0, 0, 0)  # 去掉多余边距

# 初始化QTreeView
self.CenterPane.ItemDsply = QTreeView()
layout.addWidget(self.CenterPane.ItemDsply)

2. 设置QTreeView的列宽自适应策略

这是最关键的一步，告诉TreeView如何调整列宽来适配视图宽度：

• 如果想让所有列平均分配可用宽度，用Stretch模式：

from PyQt5.QtWidgets import QHeaderView

self.CenterPane.ItemDsply.header().setSectionResizeMode(QHeaderView.Stretch)

• 如果想让列宽先适应内容，最后一列拉伸填充剩余空间，用这个组合：

self.CenterPane.ItemDsply.header().setSectionResizeMode(QHeaderView.ResizeToContents)
self.CenterPane.ItemDsply.header().setStretchLastSection(True)

3. 监听Dock停靠状态变化，触发列宽更新

有时候主窗口尺寸调整后，TreeView不会立刻重新计算列宽，我们可以监听Dock的topLevelChanged信号（当Dock从停靠变浮动或反之触发），手动触发列宽更新：

from PyQt5.QtCore import QTimer

# 假设你有两个DockWidget：dock_left和dock_right
self.dock_left.topLevelChanged.connect(self.adjust_treeview)
self.dock_right.topLevelChanged.connect(self.adjust_treeview)

def adjust_treeview(self, is_floating):
    # 用定时器延迟100ms执行，确保主窗口已经完成尺寸调整
    QTimer.singleShot(100, self.update_tree_columns)

def update_tree_columns(self):
    # 如果你用的是ResizeToContents模式，先让列适应内容
    self.CenterPane.ItemDsply.resizeColumnsToContents()
    # 更新视图布局，确保所有列都显示出来
    self.CenterPane.ItemDsply.viewport().update()
    self.CenterPane.layout().update()

为什么你之前的方法没用？ #

你调用的updateGeometry()和手动触发resizeEvent只是更新了控件的几何信息，但如果TreeView本身没有设置自适应列宽的策略，它不会主动调整列的宽度来适配新的视图尺寸。只有结合布局设置+列宽策略+主动触发更新，才能解决问题。

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