PyQt QDockWidget浮动调整大小后右侧停靠动画消失无法正常停靠

问题背景 #

当前布局中初始停靠在右侧的QDockWidget内部包含表格，通过绑定topLevelChanged()信号实现QDockWidget浮动时主窗口自动收缩填充空白的效果，绑定逻辑如下：

self.log_dock.topLevelChanged.connect(self.resize_dock)

def resize_dock(self):
        layout = self.tb_utils.findChild(QtWidgets.QLayout)
        layout.setExpanded(True)
        self.adjustSize()

上述功能实现正常，但触发后QDockWidget无法直接停靠回原右侧位置，也不会触发窗口展开动画，仅手动调整主窗口尺寸、或将dock先移到其他停靠区再移回时才能正常停靠，交互体验不符合预期。

根因分析 #

1. 原有槽函数未区分dock的浮动/停靠状态，无论哪种状态都执行相同的布局收缩、窗口调整逻辑，停靠时也错误地压缩了停靠区域的预留空间，导致Qt无法判定停靠位置。
2. topLevelChanged信号触发时，Qt内部还未完成dock状态的更新，同步调用adjustSize()会基于错误的布局参数计算窗口尺寸，进一步破坏停靠区域的判定逻辑。

修复方案 #

修改槽函数逻辑，区分状态并延迟执行尺寸调整操作，修改后的完整代码如下：

from PyQt5 import uic
from PyQt5.QtWidgets import QApplication, QMainWindow, QLayout
from PyQt5.QtCore import QTimer
import sys

gui = uic.loadUiType('dock_behavior.ui')[0]

class Window(QMainWindow, gui):
    def __init__(self):
        super(Window, self).__init__()
        self.setupUi(self)
        self._connectEvents()
        
    def _connectEvents(self):
        self.dockWidget.topLevelChanged.connect(self.resize_dock)
        self.show_dock.toggled.connect(self.enable_dock)
        
    def resize_dock(self, is_floating):
        # 浮动状态：收缩主窗口填充空白
        if is_floating:
            QTimer.singleShot(0, self._update_floating_layout)
        # 停靠状态：还原布局预留停靠空间
        else:
            QTimer.singleShot(0, self._update_docked_layout)
    
    def _update_floating_layout(self):
        layout = self.toolBar.findChild(QLayout)
        layout.setExpanded(True)
        self.adjustSize()
    
    def _update_docked_layout(self):
        layout = self.toolBar.findChild(QLayout)
        layout.setExpanded(False)
        self.adjustSize()
                
    def enable_dock(self):
        self.dockWidget.toggleViewAction().trigger()
        
if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(app.exec_())

修复说明 #

• 利用topLevelChanged信号自带的is_floating参数区分状态，浮动时收缩布局、停靠时还原布局。
• 通过QTimer.singleShot(0, ...)将布局调整逻辑放到Qt事件队列末尾，等内部状态更新完成后再执行，避免状态不同步导致的尺寸计算错误。
• 调整后拖动dock回右侧区域时会正常显示停靠预览，松开后自动展开主窗口，无需额外手动操作。

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