Sharing Menus Between MDI Child Windows

WINDOWS   | WINDOWS NT

The information in this article applies to:

• The Microsoft Foundation Classes (MFC) included with:

      - Microsoft Visual C++ for Windows, versions 1.0 and 1.5
      - Microsoft Visual C++ 32-bit Edition, versions 1.0, 2.0, and 4.0
  

SUMMARY

The document-template model used in the MFC assumes that each template will have its own set of distinct resources that are all identified by the same resource ID. However, when dealing with similar MDI child windows, you may want to conserve resource space and have MDI child windows share the same menu resource.

MORE INFORMATION

Each CMultiDocTemplate object has a member variable, "m_hMenuShared", that stores the handle of the menu to be used for that child window. However, because the default CMultiDocTemplate object assumes that it is the only user of this member variable, a new class (for example, CSharedDocTemplate) must be derived to avoid having the CMultiDocTemplate destructor call DestroyMenu on the shared menu handle:

   class CSharedDocTemplate : public CMultiDocTemplate
   {
     public:
       CSharedDocTemplate(UINT nIDResource, CRuntimeClass* pDocClass,
           CRuntimeClass* pFrameClass, CRuntimeClass* pViewClass);

       virtual ~CSharedDocTemplate();
   };

   CSharedDocTemplate::CSharedDocTemplate(UINT nIDResource,
     CRuntimeClass* pDocClass, CRuntimeClass* pFrameClass,
     CRuntimeClass* pViewClass) : CMultiDocTemplate(nIDResource, pDocClass,
                                    pFrameClass, pViewClass)
   {
   }

   CSharedDocTemplate::~CSharedDocTemplate()
   {
     // This prevents the base class virtual destructor from
     // destroying the menu resource (i.e. its checks to make
     // sure the handle isn't NULL)

     m_hMenuShared = NULL;
   }

   class CMyApp : public CWinApp
   {
   public:
      HMENU m_ghMenuShared;

      //...
   };

   BOOL CMyApp::InitInstance()
   {
      ...

      // New member of CWinApp derived class to store menu handle
      m_ghMenuShared = ::LoadMenu(m_hInstance,
         MAKEINTRESOURCE(IDR_SHAREDMENU));

      CSharedDocTemplate* pDocTemplate;
      pDocTemplate = new CSharedDocTemplate(
                         IDR_MYTYPE,  // No menu resource should exist for
                                      // this ID, the menu is set manually
                         RUNTIME_CLASS(CMDIMyDoc),
                         RUNTIME_CLASS(CMDIChildWnd),
                         RUNTIME_CLASS(CMDIMyView));
      pDocTemplate->m_hMenuShared = m_ghMenuShared;
      AddDocTemplate(pDocTemplate);

      ...
   }

   -or-

   BOOL CMyApp::InitInstance()
   {
      ...

      m_ghMenuShared = ::LoadMenu(m_hInstance,
         MAKEINTRESOURCE(IDR_SHAREDMENU));

      if (!m_templateList.IsEmpty())
      {
         CDocTemplate *pDocTemplate;

         for (POSITION rPos = m_templateList.GetHeadPosition();
            rPos != NULL;)
         {
            pDocTemplate = m_templateList.GetNext(rPos);
            if (pDocTemplate->IsKindOf(RUNTIME_CLASS(CSharedDocTemplate)))
               ((CSharedDocTemplate *)pDocTemplate)->m_hMenuShared =
                                                     m_ghMenuShared;
         }
      }

      ...
   }

   int CMyApp::ExitInstance()
   {
      ::DestroyMenu(m_ghMenuShared);
   }