Compartilhar via


Função CreatePopupMenu (winuser.h)

Cria um menu suspenso, submenu ou menu de atalho. O menu inicialmente está vazio. Você pode inserir ou acrescentar itens de menu usando a função InsertMenuItem . Você também pode usar a função InsertMenu para inserir itens de menu e a função AppendMenu para acrescentar itens de menu.

Sintaxe

HMENU CreatePopupMenu();

Valor retornado

Tipo: HMENU

Se a função for bem-sucedida, o valor retornado será um identificador para o menu recém-criado.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O aplicativo pode adicionar o novo menu a um menu existente ou pode exibir um menu de atalho chamando as funções TrackPopupMenuEx ou TrackPopupMenu .

Os recursos associados a um menu atribuído a uma janela são liberados automaticamente. Se o menu não for atribuído a uma janela, um aplicativo deverá liberar recursos do sistema associados ao menu antes de fechar. Um aplicativo libera recursos de menu chamando a função DestroyMenu .

Exemplos

Para obter um exemplo, consulte Adicionando linhas e grafos a um menu.

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

Appendmenu

Conceitual

Createmenu

Destroymenu

Insertmenu

InsertMenuItem

Menus

Referência

Setmenu

Trackpopupmenu

Trackpopupmenuex