PyQt中如何获取QDockWidget停靠位置及恢复显示？

核心结论 #

没错，必须从QMainWindow入手——QDockWidget的停靠区域、布局顺序这类状态完全由主窗口管理，自身没有直接提供查询接口。下面是具体实现方案：

1. 获取停靠状态信息 #

当QDockWidget处于非浮动状态时：

• 调用QMainWindow.dockWidgetArea(dock_widget)获取其所在的停靠区域，返回值是Qt.DockWidgetArea枚举（比如Qt.LeftDockWidgetArea、Qt.RightDockWidgetArea等）
• 如果需要精准到同区域内的停靠顺序，可以通过QMainWindow.findChildren(QDockWidget*)筛选出同一区域的所有dock，再判断当前dock的索引位置

2. 用QSettings保存状态 #

可以将以下关键信息存入配置：

• 浮动状态（isFloating()）
• 浮动时的几何尺寸（geometry()）
• 停靠时的区域（dockWidgetArea()）
• 同区域内的停靠顺序（可选，用于精准恢复布局）

示例代码：

from PyQt5.QtWidgets import QMainWindow, QDockWidget
from PyQt5.QtCore import QSettings, Qt

def save_dock_config(self, dock: QDockWidget):
    settings = QSettings("YourOrg", "YourApp")
    settings.beginGroup(f"Dock_{dock.objectName()}")
    
    settings.setValue("is_floating", dock.isFloating())
    if dock.isFloating():
        settings.setValue("geometry", dock.geometry())
    else:
        area = self.dockWidgetArea(dock)
        settings.setValue("dock_area", area)
        # 保存同区域内的顺序（可选）
        same_area_docks = [d for d in self.findChildren(QDockWidget) if self.dockWidgetArea(d) == area]
        settings.setValue("dock_index", same_area_docks.index(dock))
    
    settings.endGroup()

3. 从QSettings恢复状态 #

读取配置后分情况恢复：

• 浮动状态：直接设置几何尺寸并启用浮动
• 停靠状态：先通过addDockWidget()添加到对应区域，再调整顺序（如果保存了索引），最后调用show()

示例代码：

def restore_dock_config(self, dock: QDockWidget):
    settings = QSettings("YourOrg", "YourApp")
    settings.beginGroup(f"Dock_{dock.objectName()}")
    
    is_floating = settings.value("is_floating", type=bool)
    if is_floating:
        geom = settings.value("geometry")
        dock.setGeometry(geom)
        dock.setFloating(True)
    else:
        area = Qt.DockWidgetArea(settings.value("dock_area", type=int))
        self.addDockWidget(area, dock)
        # 恢复同区域内的顺序（可选）
        if settings.contains("dock_index"):
            index = settings.value("dock_index", type=int)
            same_area_docks = [d for d in self.findChildren(QDockWidget) if self.dockWidgetArea(d) == area]
            if 0 < index < len(same_area_docks):
                # 根据区域方向调整拆分方式
                direction = Qt.Vertical if area in [Qt.TopDockWidgetArea, Qt.BottomDockWidgetArea] else Qt.Horizontal
                self.splitDockWidget(same_area_docks[index-1], dock, direction)
    
    dock.show()
    settings.endGroup()

4. 更简便的全局方案 #

QMainWindow自带saveState()和restoreState()方法，可以一次性保存所有dock、工具栏、主窗口尺寸等布局信息，无需单独处理每个QDockWidget：

# 保存整个主窗口布局
def save_window_layout(self):
    settings = QSettings("YourOrg", "YourApp")
    settings.setValue("window_state", self.saveState())

# 恢复整个主窗口布局
def restore_window_layout(self):
    settings = QSettings("YourOrg", "YourApp")
    if settings.contains("window_state"):
        self.restoreState(settings.value("window_state"))

这个方法会自动处理所有dock的停靠位置、浮动状态，推荐优先使用。

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