Função RemoveMenu (winuser.h)

Artigo
03/04/2024

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)