Menus (Menus e Outros Recursos)

Esta seção descreve os menus e explica como usá-los.

Nesta secção

Designação	Descrição
Sobre os menus	Discute menus.
Usando menus	Fornece exemplos de código de tarefas relacionadas a menus.
de referência do menu	Contém a referência da API.

Funções do menu

Designação	Descrição
AppendMenu	Acrescenta um novo item ao final da barra de menus, menu suspenso, submenu ou menu de atalho especificado. Você pode usar essa função para especificar o conteúdo, a aparência e o comportamento do item de menu.
CheckMenuItem	Define o estado do atributo de marca de verificação do item de menu especificado como selecionado ou limpo.
CheckMenuRadioItem	Verifica um item de menu especificado e o torna um item de rádio. Ao mesmo tempo, a função limpa todos os outros itens de menu no grupo associado e limpa o sinalizador de tipo de item de rádio para esses itens.
CreateMenu	Cria um menu. O menu está inicialmente vazio, mas pode ser preenchido com itens de menu usando o InsertMenuItem, AppendMenu e funções de InsertMenu.
CreatePopupMenu	Cria um menu suspenso, submenu ou menu de atalho. O menu está inicialmente vazio. Você pode inserir ou acrescentar itens de menu usando a funçãoInsertMenuItem. Você também pode usar a funçãoInsertMenupara inserir itens de menu e a função AppendMenu para acrescentar itens de menu.
DeleteMenu	Exclui um item do menu especificado. Se o item de menu abrir um menu ou submenu, essa função destrói a alça para o menu ou submenu e libera a memória usada pelo menu ou submenu.
DestroyMenu	Destrói o menu especificado e libera qualquer memória que o menu ocupa.
DrawMenuBar	Redesenha a barra de menus da janela especificada. Se a barra de menus mudar após o sistema ter criado a janela, esta função deve ser chamada para desenhar a barra de menus alterada.
EnableMenuItem	Habilita, desabilita ou acinzenta o item de menu especificado.
EndMenu	Encerra o menu ativo do thread de chamada.
GetMenu	Recupera um identificador para o menu atribuído à janela especificada.
GetMenuBarInfo	Recupera informações sobre a barra de menus especificada.
GetMenuCheckMarkDimensions	Recupera as dimensões do bitmap de marca de verificação padrão. O sistema exibe esse bitmap ao lado dos itens de menu selecionados. Antes de chamar a função deSetMenuItemBitmapspara substituir o bitmap de marca de verificação padrão para um item de menu, um aplicativo deve determinar o tamanho correto do bitmap chamando GetMenuCheckMarkDimensions.
GetMenuDefaultItem	Determina o item de menu padrão no menu especificado.
GetMenuInfo	Recupera informações sobre um menu especificado.
GetMenuItemCount	Recupera o número de itens no menu especificado.
GetMenuItemID	Recupera o identificador de item de menu de um item de menu localizado na posição especificada em um menu.
GetMenuItemInfo	Recupera informações sobre um item de menu.
GetMenuItemRect	Recupera o retângulo delimitador para o item de menu especificado.
GetMenuState	Recupera os sinalizadores de menu associados ao item de menu especificado. Se o item de menu abrir um submenu, essa função também retornará o número de itens no submenu.
GetMenuString	Copia a cadeia de caracteres de texto do item de menu especificado para o buffer especificado.
GetSubMenu	Recupera um identificador para o menu suspenso ou submenu ativado pelo item de menu especificado.
GetSystemMenu	Permite que o aplicativo acesse o menu da janela (também conhecido como menu do sistema ou menu de controle) para copiar e modificar.
HiliteMenuItem	Realça ou remove o realce de um item numa barra de menus.
InsertMenuItem	Insere um novo item de menu na posição especificada em um menu.
IsMenu	Determina se uma alça é uma alça de menu.
LoadMenu	Carrega o recurso de menu especificado do arquivo executável (.exe) associado a uma instância do aplicativo.
LoadMenuIndirect	Carrega o modelo de menu especificado na memória.
MenuItemFromPoint	Determina qual item de menu, se houver, está no local especificado.
ModifyMenu	Altera um item de menu existente. Essa função é usada para especificar o conteúdo, a aparência e o comportamento do item de menu.
RemoveMenu	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 destrói o menu ou sua alça, permitindo que o menu seja reutilizado. Antes que essa função seja chamada, a funçãoGetSubMenu deve recuperar um identificador para o menu suspenso ou submenu.
SetMenu	Atribui um novo menu à janela especificada.
SetMenuDefaultItem	Define o item de menu padrão para o menu especificado.
SetMenuInfo	Define informações para um menu especificado.
SetMenuItemBitmaps	Associa o bitmap especificado a um item de menu. Se o item de menu estiver selecionado ou limpo, o sistema exibirá o bitmap apropriado ao lado do item de menu.
SetMenuItemInfo	Altera informações sobre um item de menu.
TrackPopupMenu	Exibe um menu de atalho no local especificado e rastreia a seleção de itens no menu. O menu de atalho pode aparecer em qualquer lugar na tela.
TrackPopupMenuEx	Exibe um menu de atalho no local especificado e rastreia a seleção de itens no menu de atalho. O menu de atalho pode aparecer em qualquer lugar na tela.

A função a seguir está obsoleta.

Designação	Descrição
InsertMenu	Insere um novo item de menu em um menu, movendo outros itens para baixo no menu. Nota: A funçãoInsertMenufoi substituída pela funçãoInsertMenuItem. Você ainda pode usar InsertMenu, no entanto, se você não precisar de nenhum dos recursos estendidos do InsertMenuItem.

Notificações de menu

Designação	Descrição
WM_COMMAND	Enviado quando o usuário seleciona um item de comando em um menu, quando um controle envia uma mensagem de notificação para sua janela pai ou quando um pressionamento de tecla acelerador é traduzido.
WM_CONTEXTMENU	Informa uma janela que o usuário clicou no botão direito do mouse (clicou com o botão direito do mouse) na janela.
WM_ENTERMENULOOP	Informa o procedimento da janela principal de um aplicativo que um loop modal de menu foi inserido.
WM_EXITMENULOOP	Informa o procedimento da janela principal de um aplicativo que um loop modal de menu foi encerrado.
WM_GETTITLEBARINFOEX	Enviado para solicitar informações estendidas da barra de título. Uma janela recebe esta mensagem através da sua função WindowProc.
WM_MENUCOMMAND	Enviado quando o usuário faz uma seleção a partir de um menu.
WM_MENUDRAG	Enviado ao proprietário de um menu de arrastar e soltar quando o usuário arrasta um item de menu.
WM_MENUGETOBJECT	Enviado ao proprietário de um menu de arrastar e soltar quando o cursor do mouse entra em um item de menu ou se move do centro do item para a parte superior ou inferior do item.
WM_MENURBUTTONUP	Enviado quando o usuário libera o botão direito do mouse enquanto o cursor está em um item de menu.
WM_NEXTMENU	Enviado para um aplicativo quando a tecla de seta para a direita ou para a esquerda é usada para alternar entre a barra de menus e o menu do sistema.
WM_UNINITMENUPOPUP	Enviado quando um menu suspenso ou submenu foi destruído.

Estruturas de Menu

Designação	Descrição
MDINEXTMENU	Contém informações sobre o menu a ser ativado.
MENUBARINFO	Contém informações da barra de menus.
MENUEX_TEMPLATE_HEADER	Define o cabeçalho de um modelo de menu estendido. Esta definição de estrutura é apenas para explicação; ele não está presente em nenhum arquivo de cabeçalho padrão.
MENUEX_TEMPLATE_ITEM	Define um item de menu em um modelo de menu estendido. Esta definição de estrutura é apenas para explicação; ele não está presente em nenhum arquivo de cabeçalho padrão.
MENUGETOBJECTINFO	Contém informações sobre o menu em que o cursor do mouse está.
MENUINFO	Contém informações sobre um menu.
MENUITEMINFO	Contém informações sobre um item de menu.
MENUITEMTEMPLATE	Define um item de menu em um modelo de menu.
MENUITEMTEMPLATEHEADER	Define o cabeçalho de um modelo de menu. Um modelo de menu completo consiste em um cabeçalho e uma ou mais listas de itens de menu.
TPMPARAMS	Contém parâmetros estendidos para a funçãoTrackPopupMenuEx.