迁移至MFC Feature Pack的MDI应用重置CDockablePane布局方法问询

没问题，我之前做过类似的需求，给你梳理几个靠谱的实现方案，亲测能解决包括TabbedPane在内的布局重置问题：

一、清除注册表中的布局缓存（核心步骤） #

MFC默认会把工具栏、停靠窗格的布局信息存在注册表的HKEY_CURRENT_USER\Software\[你的应用程序名]\[主框架类名]路径下，其中Workspace键就是存储布局的关键项。要重置布局，第一步就是删掉这个键，让应用加载时回归默认布局。

你可以写一个工具函数来完成这个操作：

BOOL ResetLayoutRegistry()
{
    CRegKey regKey;
    CString strAppName = AfxGetApp()->m_pszAppName;
    CString strMainFrameClass = AfxGetMainWnd()->GetRuntimeClass()->m_lpszClassName;
    CString strRegPath;
    strRegPath.Format(_T("Software\\%s\\%s"), strAppName, strMainFrameClass);

    LONG lResult = regKey.Open(HKEY_CURRENT_USER, strRegPath, KEY_WRITE);
    if (lResult == ERROR_SUCCESS)
    {
        // 删除存储布局的Workspace键
        lResult = regKey.DeleteValue(_T("Workspace"));
        regKey.Close();
        // 键不存在也视为成功（说明本来就是初始状态）
        return (lResult == ERROR_SUCCESS || lResult == ERROR_FILE_NOT_FOUND);
    }
    return FALSE;
}

二、运行时即时重置布局（无需重启应用） #

如果不想让用户重启应用，删除注册表后，还需要手动触发主框架重新加载初始布局：

1. 重置工具栏状态
   直接手动设置工具栏的初始停靠位置，比读取注册表更可靠：

// 假设你的工具栏成员变量是m_wndToolBar1、m_wndToolBar2
m_wndToolBar1.EnableDocking(CBRS_ALIGN_ANY);
m_wndToolBar2.EnableDocking(CBRS_ALIGN_ANY);
EnableDocking(CBRS_ALIGN_ANY);

// 重新停靠到初始位置（比如顶部）
DockControlBar(&m_wndToolBar1, AFX_IDW_DOCKBAR_TOP);
DockControlBar(&m_wndToolBar2, AFX_IDW_DOCKBAR_TOP);

2. 重置停靠窗格（含TabbedPane处理）
   要把嵌入到TabbedPane里的窗格分离出来，再恢复初始停靠状态：

// 第一步：遍历所有停靠窗格，分离标签页中的窗格
CObList& listPanes = GetDockingManager()->GetPanes();
POSITION pos = listPanes.GetHeadPosition();
while (pos != NULL)
{
    CDockablePane* pPane = (CDockablePane*)listPanes.GetNext(pos);
    if (pPane->GetParentTabbedPane() != NULL)
    {
        // 从标签页容器中分离当前窗格
        pPane->GetParentTabbedPane()->DetachPane(pPane);
    }
    // 先隐藏窗格，准备重新初始化
    pPane->ShowPane(FALSE, FALSE, FALSE);
}

// 第二步：重新初始化各窗格的初始停靠位置
// 假设左侧窗格是m_wndLeftPane，右侧是m_wndRightPane
m_wndLeftPane.EnableDocking(CBRS_ALIGN_LEFT);
m_wndRightPane.EnableDocking(CBRS_ALIGN_RIGHT);

DockPane(&m_wndLeftPane);
DockPane(&m_wndRightPane);

// 可选：用SplitPane调整窗格的初始尺寸比例
CSplitterWnd* pSplitter = GetDockingManager()->GetDefaultPaneDivider();
if (pSplitter != NULL)
{
    pSplitter->SplitPane(m_wndLeftPane, m_wndRightPane, 200); // 200为左侧窗格初始宽度
}

三、避免重置后立即保存布局 #

主框架关闭时会自动调用SaveBarState保存当前布局，容易把刚重置的布局又存回注册表。可以加个标志位控制：

// 主框架类中添加成员变量
BOOL m_bSkipSaveLayout = FALSE;

// 在重置布局的函数中设置标志
m_bSkipSaveLayout = TRUE;

// 重写主框架的SaveBarState方法
void CMainFrame::SaveBarState(LPCTSTR lpszProfileName)
{
    if (!m_bSkipSaveLayout)
    {
        CFrameWndEx::SaveBarState(lpszProfileName);
    }
    // 重置标志，确保下次正常保存用户自定义布局
    m_bSkipSaveLayout = FALSE;
}

四、完整重置流程示例 #

把上面的步骤整合到菜单命令或按钮点击事件中：

void CMainFrame::OnResetLayout()
{
    // 1. 清除注册表布局缓存
    ResetLayoutRegistry();

    // 2. 重置工具栏
    ResetToolBars(); // 这里把前面的工具栏重置代码封装成函数

    // 3. 重置停靠窗格（含TabbedPane处理）
    ResetDockingPanes(); // 封装窗格重置代码

    // 4. 设置跳过保存标志，避免立即覆盖初始布局
    m_bSkipSaveLayout = TRUE;

    // 5. 刷新界面
    RecalcLayout();
}

这样用户点击重置按钮后，就能立即恢复到应用首次启动时的初始状态，包括把嵌入到标签页的窗格还原成独立停靠样式。

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