Função CreateMenu (winuser.h)

Artigo
11/18/2024

Cria um menu. O menu está inicialmente vazio, mas pode ser preenchido com itens de menu usando as funções InsertMenuItem, AppendMenue InsertMenu.

Sintaxe

HMENU CreateMenu();

Valor de retorno

Tipo: HMENU

Se a função for bem-sucedida, o valor retornado será um identificador para o menu recém-criado.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Observações

Os recursos associados a um menu atribuído a uma janela são liberados automaticamente. Se o menu não for atribuído a uma janela, um aplicativo deverá liberar recursos do sistema associados ao menu antes de fechar. Um aplicativo libera recursos de menu chamando a função DestroyMenu.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll
conjunto de API	ext-ms-win-ntuser-menu-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)