Função DeleteMenu (winuser.h)

Exclui um item do menu especificado. Se o item de menu abrir um menu ou submenu, essa função destruirá o identificador para o menu ou submenu e liberará a memória usada pelo menu ou submenu.

Sintaxe

BOOL DeleteMenu(
  [in] HMENU hMenu,
  [in] UINT  uPosition,
  [in] UINT  uFlags
);

Parâmetros

[in] hMenu

Tipo: HMENU

Um identificador para o menu a ser alterado.

[in] uPosition

Tipo: UINT

O item de menu a ser excluído, conforme determinado pelo parâmetro uFlags .

[in] uFlags

Tipo: UINT

Indica como o parâmetro uPosition é interpretado. Esse parâmetro deve usar um dos valores a seguir.

Valor Significado
MF_BYCOMMAND
0x000000000L
Indica que uPosition fornece o identificador do item de menu. O sinalizador MF_BYCOMMAND será o sinalizador padrão se nem o sinalizador MF_BYCOMMAND nem MF_BYPOSITION for especificado.
MF_BYPOSITION
0x00000400L
Indica que uPosition fornece a posição relativa baseada em zero do item de menu.

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

O aplicativo deve chamar a função DrawMenuBar sempre que um menu for alterado, se o menu estiver em uma janela exibida.

Exemplos

Para obter um exemplo, consulte Exemplo de visualizador de área de transferência.

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

Drawmenubar

Menus

Referência

RemoveMenu