CMDIFrameWnd::MDISetMenu

Artigo
08/25/2010

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

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

Parâmetros

pFrameMenu
Especifica o menu do novo menu janela do quadro.If NULO, o menu não será alterado.
pWindowMenu
Especifica o menu do menu pop-up janela novo.If NULO, o menu não será alterado.

Valor de retorno

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

Comentários

Depois de telefonar ndo MDISetMenu, um aplicativo deve telefonar o DrawMenuBar função de membro de CWnd Para atualizar a BAR de menus.

Se essa telefonar substitui o menu pop-up de janela, itens de menu de janela filho MDI são removidos do menu janela anterior e adicionados ao menu pop-up janela novo.

Se uma janela filho MDI é maximizada e essa telefonar substitui o menu da janela de quadro MDI, os controles de menu e a restauração do controle são removidos do menu janela do quadro anterior e adicionados ao novo menu.

Não chame essa função de membro, se você usar a estrutura para gerenciar 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);
}