Função DeleteMenu (winuser.h)

Artigo
08/27/2023

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)