Compartilhar via


Função DestroyMenu (winuser.h)

Destrói o menu especificado e libera qualquer memória que o menu ocupa.

Sintaxe

BOOL DestroyMenu(
  [in] HMENU hMenu
);

Parâmetros

[in] hMenu

Tipo: HMENU

Um identificador para o menu a ser destruído.

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Antes de fechar, um aplicativo deve usar a função DestroyMenu para destruir um menu não atribuído a uma janela. Um menu atribuído a uma janela é destruído automaticamente quando o aplicativo é fechado.

DestroyMenu é recursivo, ou seja, destruirá o menu e todo o seu submenu.

Exemplos

Para obter um exemplo, consulte Exibindo um menu de atalho.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-menu-l1-1-0 (introduzido no Windows 8)

Confira também

Conceitual

Createmenu

Deletemenu

Menus

Referência

RemoveMenu

Setmenuiteminfo