Função RemoveMenu (winuser.h)

Exclui um item de menu ou desanexa um submenu do menu especificado. Se o item de menu abrir um menu suspenso ou submenu, RemoveMenu não destruirá o menu ou seu identificador, permitindo que o menu seja reutilizado. Antes que essa função seja chamada, a função GetSubMenu deve recuperar um identificador para o menu suspenso ou submenu.

Sintaxe

BOOL RemoveMenu(
  [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. Se nem o sinalizador MF_BYCOMMAND nem MF_BYPOSITION for especificado, o sinalizador MF_BYCOMMAND será o sinalizador padrão.
MF_BYPOSITION
0x00000400L
Indica que uPosition fornece a posição relativa baseada em zero do item de menu.

Retornar valor

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.

Requisitos

Requisito Valor
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 em Windows 8)

Confira também

Conceitual

Createpopupmenu

Deletemenu

Drawmenubar

GetSubMenu

Menus

Referência