Função SetMenu (winuser.h)

  • Artigo

Atribui um novo menu à janela especificada.

Sintaxe

BOOL SetMenu(
  [in]           HWND  hWnd,
  [in, optional] HMENU hMenu
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela à qual o menu deve ser atribuído.

[in, optional] hMenu

Tipo: HMENU

Um identificador para o novo menu. Se esse parâmetro for NULL, o menu atual da janela será removido.

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

A janela é redesenhada para refletir a alteração do menu. Um menu pode ser atribuído a qualquer janela que não seja uma janela filho.

A função SetMenu substitui o menu anterior, se houver, mas não a destrói. Um aplicativo deve chamar a função DestroyMenu para realizar essa tarefa.

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-3 (introduzido no Windows 10, versão 10.0.14393)

Confira também

Conceitual

Destroymenu

GetMenu

Menus

Referência