VC中单文档框架删除菜单的调试经历

  我的技术博客已搬家至: http://www.kai-zhou.com,  其他博客已停止更新，欢迎访问查看文章的最新版本.

 最近想在VC中单文档框架中删除菜单，状态栏，工具栏 。状态栏，工具栏在CMainFrame::OnCreate中就可以注释调，但是怎么样将菜单删掉呢？百度了一下，不太好找到。只好依靠现有知识，自己找到办法了。通过跟踪调试MFC的源代码居然让我找到了办法。

  首先，我们先想办法达到在单文档界面中不显示菜单的效果。

  通过现有知识，我们知道MFC是在CMainFrame::OnCreate中生成状态栏，工具栏的。代码如下：

int CMainFrame :: OnCreate(LPCREATESTRUCT lpCreateStruct)
{
     if  (CFrameWnd :: OnCreate(lpCreateStruct)  ==   - 1 )
         return   - 1 ;

    
     if  ( ! m_wndToolBar . CreateEx(this ,  TBSTYLE_FLAT ,  WS_CHILD  |  WS_VISIBLE  |  CBRS_TOP
         |  CBRS_GRIPPER  |  CBRS_TOOLTIPS  |  CBRS_FLYBY  |  CBRS_SIZE_DYNAMIC)  ||
         ! m_wndToolBar . LoadToolBar(IDR_MAINFRAME))
    {
        TRACE0( " 未能创建工具栏 " );
         return   - 1 ;       //  未能创建
    }

     if  ( ! m_wndStatusBar . Create(this)  ||
         ! m_wndStatusBar . SetIndicators(indicators ,
           sizeof (indicators) / sizeof (UINT)))
    {
        TRACE0( " 未能创建状态栏 " );
         return   - 1 ;       //  未能创建
    }

     //  TODO: 如果不需要工具栏可停靠，则删除这三行
    m_wndToolBar . EnableDocking(CBRS_ALIGN_ANY);
    EnableDocking(CBRS_ALIGN_ANY);
    DockControlBar( & m_wndToolBar);
                      return   0 ;
}

  所以如果不想要状态栏，工具栏，直接在CMainFrame::OnCreate中将相关代码注释调就行了。那么，菜单相关的代码在哪呢？遍历一遍CMainFrame类，没找到。根据代码相关性，既然状态栏，工具栏是在 CMainFrame::OnCreate中生成的，那么菜单估计也是在这个函数里面生成的。

  首先在 if (CFrameWnd::OnCreate(lpCreateStruct) == -1) 处下断点，进入函数内部，代码如下：

int CFrameWnd :: OnCreate(LPCREATESTRUCT lpcs)
{
    ENSURE_ARG(lpcs  !=   NULL );
    CCreateContext *  pContext  =  (CCreateContext * )lpcs -> lpCreateParams;
     return  OnCreateHelper(lpcs ,  pContext);
}

  继续进入OnCreateHelper函数，代码如下：

int CFrameWnd :: OnCreateHelper(LPCREATESTRUCT lpcs ,  CCreateContext *  pContext)
{
     if  (CWnd :: OnCreate(lpcs)  ==   - 1 )
         return   - 1 ;

     //  create special children first
     if  ( ! OnCreateClient(lpcs ,  pContext))
    {
        TRACE(traceAppMsg ,   0 ,   " Failed to create client pane/view for frame. " );
         return   - 1 ;
    }

     //  post message for initial message string
    PostMessage(WM_SETMESSAGESTRING ,  AFX_IDS_IDLEMESSAGE);

     //  make sure the child windows have been properly sized
    RecalcLayout();

     return   0 ;    //  create ok
}

  下一步进入OnCreateClient，代码如下：

BOOL CFrameWnd :: OnCreateClient(LPCREATESTRUCT ,  CCreateContext *  pContext)
{
     //  default create client will create a view if asked for it
     if  (pContext  !=   NULL   &&  pContext -> m_pNewViewClass  !=   NULL )
    {
         if  (CreateView(pContext ,  AFX_IDW_PANE_FIRST)  ==   NULL )
             return   FALSE ;
    }
     return   TRUE ;
}

  进入CreateView，代码如下：

CWnd *  CFrameWnd :: CreateView(CCreateContext *  pContext ,  UINT nID)
{
     ASSERT (m_hWnd  !=   NULL );
     ASSERT ( :: IsWindow(m_hWnd));
    ENSURE_ARG(pContext  !=   NULL );
    ENSURE_ARG(pContext -> m_pNewViewClass  !=   NULL );

     //  Note: can be a CWnd with PostNcDestroy self cleanup
    CWnd *  pView  =  (CWnd * )pContext -> m_pNewViewClass -> CreateObject();
     if  (pView  ==   NULL )
    {
        TRACE(traceAppMsg ,   0 ,   " Warning: Dynamic create of view type %hs failed. " ,
            pContext -> m_pNewViewClass -> m_lpszClassName);
         return   NULL ;
    }
    ASSERT_KINDOF(CWnd ,  pView);

     //  views are always created with a border!
     if  ( ! pView -> Create( NULL ,   NULL ,  AFX_WS_DEFAULT_VIEW ,
        CRect( 0 , 0 , 0 , 0 ) ,  this ,  nID ,  pContext))
    {
        TRACE(traceAppMsg ,   0 ,   " Warning: could not create view for frame. " );
         return   NULL ;         //  can't continue without a view
    }

     if  (pView -> GetExStyle()  &  WS_EX_CLIENTEDGE)
    {
         //  remove the 3d style from the frame, since the view is
        //  providing it.
        // make sure to recalc the non-client area
        ModifyStyleEx(WS_EX_CLIENTEDGE ,   0 ,  SWP_FRAMECHANGED);
    }
     return  pView;
}

  进入 if (!pView->Create(NULL, NULL, AFX_WS_DEFAULT_VIEW,CRect(0,0,0,0), this, nID, pContext))，代码如下：

BOOL CWnd :: Create(LPCTSTR lpszClassName ,
    LPCTSTR lpszWindowName ,  DWORD dwStyle ,
     const  RECT &  rect ,
    CWnd *  pParentWnd ,  UINT nID ,
    CCreateContext *  pContext)
{
     //  can't use for desktop or pop-up windows (use CreateEx instead)
     ASSERT (pParentWnd  !=   NULL );
     ASSERT ((dwStyle  &  WS_POPUP)  ==   0 );

     return  CreateEx( 0 ,  lpszClassName ,  lpszWindowName ,
        dwStyle  |  WS_CHILD ,
        rect . left ,  rect . top ,
        rect . right  -  rect . left ,  rect . bottom  -  rect . top ,
        pParentWnd -> GetSafeHwnd() ,  (HMENU)(UINT_PTR)nID ,  (LPVOID)pContext);
}

  进入CreateEx,代码如下：

BOOL CWnd :: CreateEx(DWORD dwExStyle ,  LPCTSTR lpszClassName ,
    LPCTSTR lpszWindowName ,  DWORD dwStyle ,
    int x ,  int y ,  int nWidth ,  int nHeight ,
    HWND hWndParent ,  HMENU nIDorHMenu ,  LPVOID lpParam)
{
     ASSERT (lpszClassName  ==   NULL   ||  AfxIsValidString(lpszClassName)  ||  
        AfxIsValidAtom(lpszClassName));
    ENSURE_ARG(lpszWindowName  ==   NULL   ||  AfxIsValidString(lpszWindowName));
    
     //  allow modification of several common create parameters
    CREATESTRUCT cs;
    cs . dwExStyle  =  dwExStyle;
    cs . lpszClass  =  lpszClassName;
    cs . lpszName  =  lpszWindowName;
    cs . style  =  dwStyle;
    cs . x  =  x;
    cs . y  =  y;
    cs . cx  =  nWidth;
    cs . cy  =  nHeight;
    cs . hwndParent  =  hWndParent;
    cs . hMenu  =  nIDorHMenu;
    cs . hInstance  =  AfxGetInstanceHandle();
    cs . lpCreateParams  =  lpParam;

     if  ( ! PreCreateWindow(cs))
    {
        PostNcDestroy();
         return   FALSE ;
    }

    AfxHookWindowCreate(this);
    HWND hWnd  =   :: AfxCtxCreateWindowEx(cs . dwExStyle ,  cs . lpszClass ,
            cs . lpszName ,  cs . style ,  cs . x ,  cs . y ,  cs . cx ,  cs . cy ,
            cs . hwndParent ,  cs . hMenu ,  cs . hInstance ,  cs . lpCreateParams);

# ifdef _DEBUG
     if  (hWnd  ==   NULL )
    {
        TRACE(traceAppMsg ,   0 ,   " Warning: Window creation failed: GetLastError returns 0x%8.8X " ,
            GetLastError());
    }
# endif

     if  ( ! AfxUnhookWindowCreate())
        PostNcDestroy();         //  cleanup if CreateWindowEx fails too soon

     if  (hWnd  ==   NULL )
         return   FALSE ;
     ASSERT (hWnd  ==  m_hWnd);  //  should have been set in send msg hook
     return   TRUE ;
}

  注意 cs.hMenu = nIDorHMenu;  这段代码明显是与菜单有关的代码，那么找到了框架是如何生成菜单的，将菜单加入到框架中的，我们又如何在框架中将菜单删除呢？菜单的赋值是赋给CREATESTRUCT结构，所以猜测CREATESTRUCT结构可以控制菜单。返回到CMainFrame中，我们可以看到CMainFrame::OnCreate()的参数是LPCREATESTRUCT，所以先修改CMainFrame::OnCreate()如下：

int CMainFrame :: OnCreate(LPCREATESTRUCT lpCreateStruct)
{
    lpCreateStruct -> hMenu  =   NULL ;
     if  (CFrameWnd :: OnCreate(lpCreateStruct)  ==   - 1 )
         return   - 1 ;
   return   0 ;l
}

  编译，运行。还有菜单。 再回到CMainFrame中，发现PreCreateWindow也有CREATESTRUCT结构，修改代码如下：

BOOL CMainFrame :: PreCreateWindow(CREATESTRUCT &  cs)
{
    cs . hMenu  =   NULL ;
     if (  ! CFrameWnd :: PreCreateWindow(cs) )
         return   FALSE ;
     //  TODO: 在此处通过修改
    //  CREATESTRUCT cs 来修改窗口类或样式

     return   TRUE ;
}

  编译运行，成功了。菜单没了。

  第二步，既然菜单没用了，那么我们可不可以把wizard自动生成的菜单删除调呢？说干就干，删除菜单IDR_MAINFRAME，编译运行，什么“建立空文档失败”，程序直接退出。继续跟踪，调试吧。

  首先估计是在CMainFrame中出的问题，在CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)中下断点，编译运行，结果没进入断点，程序就出错了，那在App类的InitInstance()中下断点吧。跟踪，发现是在

     if  ( ! ProcessShellCommand(cmdInfo))
         return  FALSE;

 中出错的。再次调试，进入ProcessShellCommand()函数内部，这次出错地方在

     case  CCommandLineInfo::FileNew:
         if  ( ! AfxGetApp() -> OnCmdMsg(ID_FILE_NEW,  0 , NULL, NULL))
            OnFileNew();

  同理，一步一步的，我们就可以找到最后出错的确切地点，中间过程省略。最后发现出错代码如下：

BOOL CFrameWnd :: Create(LPCTSTR lpszClassName ,
    LPCTSTR lpszWindowName ,
    DWORD dwStyle ,
     const  RECT &  rect ,
    CWnd *  pParentWnd ,
    LPCTSTR lpszMenuName ,
    DWORD dwExStyle ,
    CCreateContext *  pContext)
{
    HMENU hMenu  =   NULL ;
     if  (lpszMenuName  !=   NULL )
    {
         //  load in a menu that will get destroyed when window gets destroyed
        HINSTANCE hInst  =  AfxFindResourceHandle(lpszMenuName ,  ATL_RT_MENU);
         if  ((hMenu  =   :: LoadMenu(hInst ,  lpszMenuName))  ==   NULL )
        {
            TRACE(traceAppMsg ,   0 ,   " Warning: failed to load menu for CFrameWnd. " );
            PostNcDestroy();             //  perhaps delete the C++ object
             return   FALSE ;
        }
    }

    m_strTitle  =  lpszWindowName;     //  save title for later

     if  ( ! CreateEx(dwExStyle ,  lpszClassName ,  lpszWindowName ,  dwStyle ,
        rect . left ,  rect . top ,  rect . right  -  rect . left ,  rect . bottom  -  rect . top ,
        pParentWnd -> GetSafeHwnd() ,  hMenu ,  (LPVOID)pContext))
    {
        TRACE(traceAppMsg ,   0 ,   " Warning: failed to create CFrameWnd. " );
         if  (hMenu  !=   NULL )
            DestroyMenu(hMenu);
         return   FALSE ;
    }

     return   TRUE ;
}

  在LoadMenu的时候出错了，所以执行PostNcDestroy()函数了。找到了错误所在，怎么修改代码呢?

  仔细阅读，发现Create()函数是在CFrameWnd类中，而CMainFrame类的父类就是CFrameWnd类，再一查，发现了CFrameWnd::Create()是虚函数，所以只要我们在CMainFrame中实现Create(),并将其中加载菜单的相关代码去掉应该就可以了，修改代码如下：

BOOL CMainFrame :: Create(LPCTSTR lpszClassName ,
                    LPCTSTR lpszWindowName ,
                    DWORD dwStyle  /* = WS_OVERLAPPEDWINDOW */ ,
                     const  RECT &  rect /*  = rectDefault */ ,
                    CWnd *  pParentWnd  /* = NULL */ ,          //  != NULL for popups
                    LPCTSTR lpszMenuName /*  = NULL */ ,
                    DWORD dwExStyle /*  = 0 */ ,
                    CCreateContext *  pContext /*  = NULL */ )
{
    HMENU hMenu  =   NULL ;
     if  (lpszMenuName  !=   NULL )
    {
    }
    m_strTitle  =  lpszWindowName;     //  save title for later
     if  ( ! CreateEx(dwExStyle ,  lpszClassName ,  lpszWindowName ,  dwStyle ,
        rect . left ,  rect . top ,  rect . right  -  rect . left ,  rect . bottom  -  rect . top ,
        pParentWnd -> GetSafeHwnd() ,  hMenu ,  (LPVOID)pContext))
    {
        TRACE(traceAppMsg ,   0 ,   " Warning: failed to create CFrameWnd. " );
         if  (hMenu  !=   NULL )
            DestroyMenu(hMenu);
         return   FALSE ;
    }
}

  编译，运行，成功了。

  以前写代码总是查上网，翻书，看帮助查资料，现在才发现源代码也是很好的资料。上网，翻阅书籍查资料固然不错，但是那是学习别人已有的知识，自己解决问题的能力没什么大的提高。通过研究源代码，我们可以在没有任何书籍，文档的情况下解决问题。这是我第一次深入跟踪到MFC源代码内部进行调试，希望对像我一样的初学者有帮助。