Compartilhar via


CMenu::CreateMenu

Criar um menu e anexá-la ao objeto de CMenu .

BOOL CreateMenu( );

Valor de retorno

Diferente de zero se o menu foi criado com êxito; se não 0.

Comentários

O menu está inicialmente vazia. Os itens de menu podem ser adicionados usando a função de membro de AppendMenu ou de InsertMenu .

Se o menu é atribuído a uma janela, é destruído automaticamente quando a janela é destruída.

Antes de sair, um aplicativo deve liberar os recursos do sistema associados com um menu se o menu não é atribuído a uma janela. Um aplicativo libera um menu chamar a função de membro de DestroyMenu .

Exemplo

// The code fragment below shows how to create a new menu for the 
// application window using CreateMenu() and CreatePopupMenu(). 
// Then, the created menu will replace the current menu of the 
// application. The old menu will be destroyed with DestroyMenu(). 
// NOTE: The code fragment below is done in a CFrameWnd-derived class. 

// Create a new menu for the application window.
VERIFY(m_NewMenu.CreateMenu());

// Create a "File" popup menu and insert this popup menu to the
// new menu of the application window. The "File" menu has only
// one menu item, i.e. "Exit".
VERIFY(m_FileMenu.CreatePopupMenu());
m_FileMenu.AppendMenu(MF_STRING, ID_APP_EXIT, _T("E&xit"));
m_NewMenu.AppendMenu(MF_POPUP, (UINT_PTR)m_FileMenu.m_hMenu, _T("&File"));

// Remove and destroy old menu
SetMenu(NULL);
CMenu* old_menu = CMenu::FromHandle(m_hMenuDefault);
old_menu->DestroyMenu();

// Add new menu.
SetMenu(&m_NewMenu);

// Assign default menu
m_hMenuDefault = m_NewMenu.m_hMenu;

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CMenu

Gráfico da hierarquia

CMenu::CMenu

CMenu::DestroyMenu

CMenu::InsertMenu

CWnd::SetMenu

CreateMenu

CMenu::AppendMenu