CMDIFrameWnd::MDISetMenu

Artigo
02/25/2013

Substituir o menu de uma janela de quadro MDI, no menu de janela pop-up, ou ambos.

CMenu* MDISetMenu(
   CMenu* pFrameMenu,
   CMenu* pWindowMenu 
);

Parâmetros

pFrameMenu
Especifica o menu do novo menu de quadro- janela.NULO, Se o menu não é alterado.
pWindowMenu
Especifica o menu do menu pop-up de nova janela.NULO, Se o menu não é alterado.

Valor de retorno

Um ponteiro para o menu de quadro- janela substituído por esta mensagem.O ponteiro pode ser temporário e não deve ser armazenado para uso posterior.

Comentários

Após chamar MDISetMenu, um aplicativo deve chamar a função de membro de DrawMenuBar de CWnd para atualizar a barra de menus.

Se esta chamada substitui o menu pop-up da janela, os itens de menu janela filho MDI são removidos de menu de janela anterior e colocado no menu pop-up de nova janela.

Se uma janela filho MDI é maximizada e essa chamada substitui o menu de quadro- janela MDI, os controles de menu de controle de minimizar e são removidos de menu anterior de quadro- janela e adicionados ao novo menu.

Não chamar essa função de membro se você usar a estrutura para gerenciar as janelas filho MDI.

Exemplo

// CMdiView::OnReplaceMenu() is a menu command handler for CMdiView
// class, which in turn is a CView-derived class. It loads a new
// menu resource and replaces the main application window's menu
// bar with this new menu.
void CMdiView::OnReplaceMenu() 
{
   // Load a new menu resource named IDR_SHORT_MENU. m_hDefaultMenu is 
   // a member variable of CMdiDoc class (a CDocument-derived class). 
   // Its type is HMENU.
   CMdiDoc* pdoc = (CMdiDoc*)GetDocument();
   pdoc->m_hDefaultMenu = 
      ::LoadMenu(AfxGetResourceHandle(), MAKEINTRESOURCE(IDR_SHORT_MENU));
   if (pdoc->m_hDefaultMenu == NULL)
      return;

   // Get the parent window of this view window. The parent window is
   // a CMDIChildWnd-derived class. We can then obtain the MDI parent 
   // frame window using the CMDIChildWnd*. Then, replace the current 
   // menu bar with the new loaded menu resource.
   CMDIFrameWnd* frame = ((CMDIChildWnd*)GetParent())->GetMDIFrame();
   frame->MDISetMenu(CMenu::FromHandle(pdoc->m_hDefaultMenu), NULL);
   frame->DrawMenuBar();
}

// GetDefaultMenu() is an undocumented virtual function for 
// CDocument class. It allows the document to determine which 
// menu to display. m_hDefaultMenu is of type HMENU. Its value
// is initialized to NULL either in the constructor or 
// CDocument::OnNewDocument(). And the menu resource is destroyed
// in the destructor to avoid having too many menus loaded at once.
HMENU CMdiDoc::GetDefaultMenu()
{
   if (m_hDefaultMenu)
      return m_hDefaultMenu;

   return COleServerDoc::GetDefaultMenu();
}

// Initialize member variable(s) in the constructor. CMdiDoc is
// a CDocument-derived class.
CMdiDoc::CMdiDoc()
{
   // Use OLE compound files
   EnableCompoundFile();

   m_hDefaultMenu = NULL; // initialize to NULL
}

// Destroy menu resource in CMdiDoc's destructor. CMdiDoc is
// a CDocument-derived class.
CMdiDoc::~CMdiDoc()
{
   if (m_hDefaultMenu)
      ::DestroyMenu(m_hDefaultMenu);
}