CPaneFrameWnd中的BUG(MFC Feature Pack VS 2015)

时间:2016-08-31 15:42:26

标签: c++ mfc mfc-feature-pack

miniframe类CPaneFrameWnd包含智能对接算法中的错误! 此类在MFC中用作浮动窗格的miniframe,并且可以将其停靠到父框架停靠站点或选项卡式窗格。当所有窗格只能停靠到主框架时,它工作正常,但当窗格停靠在MDI应用程序中的子框架时,此类有一个错误。重现错误的步骤:

  1. 将某个窗格解除浮动状态。
  2. 在MDI子框架中保存停靠状态:GetDockingManager()->SaveState(...)
  3. 恢复此MDI子框架的停靠状态:GetDockingManager()->LoadState(...); GetDockingManager()->SetDockState();
  4. 并尝试通过鼠标将此窗格停靠在同一帧旁边。
  5. 你不能这样。窗格由鼠标移动到框架侧但未被DOCKED。
  6. CPaneFrameWnd类源中的错误。在许多地方,类使用代码m_pDockManager != NULL ? m_pDockManager : afxGlobalUtils.GetDockingManager(GetParent());来访问其dockmanager。 但在某些课堂上,这段代码看起来像m_pDockManager != NULL ? m_pDockManager : afxGlobalUtils.GetDockingManager(this);。这就是错误的原因 - 全局函数afxGlobalUtils.GetDockingManager()无法从this指针获取停靠管理器,并尝试从this指针的父窗口获取它。它看起来像pManager != NULL ? pManager : GetDockingManager(pWnd->GetParent());。但是类CPaneFrameWnd具有无法通过afxGlobalUtils.GetDockingManager()访问的INLINE NONVIRTUAL GetParent()方法。因此,经过一些递归后,afxGlobalUtils.GetDockingManager()返回主要应用程序框架的dockmanager!当然,这个dockmanager与MDI子框架的docmanager不同。

    单一权利解决方案是将CPaneFrameWnd源(afxpaneframewnd.cpp文件)中的所有m_pDockManager != NULL ? m_pDockManager : afxGlobalUtils.GetDockingManager(this);更改为m_pDockManager != NULL ? m_pDockManager : afxGlobalUtils.GetDockingManager(GetParent());。 但这需要修补MFC代码。我们所有人都知道微软是如何懒惰的。 可能有人知道如何解决当前MFC版本中的这个错误吗?

1 个答案:

答案 0 :(得分:1)

我找到了修复错误的方法。如上所述,迷你帧类CPaneFrameWnd具有未初始化的m_pDockManager属性(它具有nullptr值)的主要问题。因此,在某些情况下,类CPaneFrameWnd无法从父级找到正确的dockmanager。该错误的解决方法是强制初始化所有迷你帧m_pDockManager属性。这方面的好地方是从注册表恢复对接状态(有问题的步骤3)。

右侧保存和加载子帧停靠状态的示例:

// Save docking state for CChildFrame class (inherited from CMDIChildWndEx)
void CChildFrame::SaveBarState(LPCTSTR lpszProfileName) const
{
    const_cast<CChildFrame*>(this)->GetDockingManager()->SaveState(lpszProfileName);

    CObList list;
    const_cast<CChildFrame*>(this)->GetDockingManager()->GetPaneList(list, FALSE, NULL, FALSE);
    if (list.GetCount() > 0) {
        POSITION pos = list.GetTailPosition();
        while (pos != NULL) {
            CMFCToolBar* pToolBar = DYNAMIC_DOWNCAST(CMFCToolBar, list.GetPrev(pos));
            if (pToolBar != nullptr) {
                pToolBar->SaveState(lpszProfileName);
            }
        }
    }
}

// Restore docking state for CChildFrame class (inherited from CMDIChildWndEx)
void CChildFrame::LoadBarState(LPCTSTR lpszProfileName)
{
    CObList list;
    GetDockingManager()->GetPaneList(list, FALSE, NULL, FALSE);
    if (list.GetCount() > 0) {
        POSITION pos = list.GetTailPosition();
        while (pos != NULL) {
            CMFCToolBar* pToolBar = DYNAMIC_DOWNCAST(CMFCToolBar, list.GetPrev(pos));
            if (pToolBar != nullptr) {
                pToolBar->LoadState(lpszProfileName);
            }
        }
    }

    GetDockingManager()->LoadState(lpszProfileName);
    GetDockingManager()->SetDockState();
    GetDockingManager()->ShowDelayShowMiniFrames(TRUE);

    // MFC BUGFIX: force assigning the child frame docking manager to all miniframes.
    for (POSITION pos = GetDockingManager()->GetMiniFrames().GetHeadPosition(); pos != NULL;)
    {
        CWnd* pWndNext = (CWnd*)GetDockingManager()->GetMiniFrames().GetNext(pos);
        if (pWndNext != nullptr && pWndNext->IsKindOf(RUNTIME_CLASS(CPaneFrameWnd))) {
            STATIC_DOWNCAST(CPaneFrameWnd, pWndNext)->SetDockingManager(GetDockingManager());
        }
    }
}

如何使用此代码:

// creating child frame and its panes, loading the saved panes docking state.
int CChildFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
    bool bRes = TBase::OnCreate(lpCreateStruct) == 0;
    if (bRes)
    {
        // enable docking
        EnableDocking(CBRS_ALIGN_ANY);

        // enable Visual Studio 2005 style docking window behavior
        CDockingManager::SetDockingMode(DT_SMART);

        // Creating toolbar, statusbar and panes. Dock them to default places.
        {
            // ....
        }
    }

    if (bRes) {
       LoadBarState(theApp.GetRegSectionPath(_T("ChildFrame")));
    }
    return bRes ? 0 : 1;
}


// destroy child frame and save panes docking state.
void CChildFrame::OnDestroy()
{
    SaveBarState(theApp.GetRegSectionPath(_T("ChildFrame")));
    TBase::OnDestroy();
}

Full sample source code