Compartilhar via


Menus (Menus e Outros Recursos)

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

Nesta seção

Nome Descrição
Sobre menus Discute menus.
Uso de Menus Fornece exemplos de código de tarefas relacionadas a menus.
Referência de menu Contém a referência de API.
Nome Descrição
Appendmenu Acrescenta um novo item ao final da barra de menus, menu suspenso, submenu ou menu de atalho especificados. 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 marcar do item de menu especificado como selecionado ou desmarcado.
CheckMenuRadioItem Seleciona um item de menu especificado e o torna um item de opção. 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 as funções InsertMenuItem, AppendMenu e InsertMenu .
Createpopupmenu 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.
Deletemenu 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.
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 for alterada depois que o sistema tiver criado a janela, essa função deverá ser chamada para desenhar a barra de menus alterada.
Enablemenuitem Habilita, desabilita ou cinza 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 especifica.
GetMenuCheckMarkDimensions Recupera as dimensões do bitmap de marca de marcar padrão. O sistema exibe esse bitmap ao lado dos itens de menu selecionados. Antes de chamar a função SetMenuItemBitmaps para substituir o bitmap de marca de marcar 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 em uma barra de menus.
InsertMenuItem Insere um novo item de menu na posição especificada em um menu.
IsMenu Determina se um identificador é um identificador de menu.
LoadMenu Carrega o recurso de menu especificado do arquivo executável (.exe) associado a uma instância de 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 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.
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 desmarcado, 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 acompanha 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 acompanha 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.

Nome Descrição
Insertmenu Insere um novo item de menu em um menu, movendo outros itens para baixo no menu. Nota: A função InsertMenu foi substituída pela função InsertMenuItem . No entanto, você ainda poderá usar InsertMenu se não precisar de nenhum dos recursos estendidos de InsertMenuItem.
Nome 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 de acelerador é traduzido.
WM_CONTEXTMENU Informa a uma janela que o usuário clicou no botão direito do mouse (clicado com o botão direito do mouse) na janela.
WM_ENTERMENULOOP Informa ao procedimento de janela main de um aplicativo que um loop modal de menu foi inserido.
WM_EXITMENULOOP Informa ao procedimento de janela main de um aplicativo que um loop modal de menu foi encerrado.
WM_GETTITLEBARINFOEX Enviado para solicitar informações da barra de título estendida. Uma janela recebe essa mensagem por meio da função WindowProc.
WM_MENUCOMMAND Enviado quando o usuário faz uma seleção de um menu.
WM_MENUDRAG Enviado ao proprietário de um menu arrastar e soltar quando o usuário arrasta um item de menu.
WM_MENUGETOBJECT Enviado ao proprietário de um menu arrastar e soltar quando o cursor do mouse entra em um item de menu ou passa 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 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.
Nome 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 para um modelo de menu estendido. Essa definição de estrutura serve 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. Essa definição de estrutura serve 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 no qual o cursor do mouse está ativado.
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ção TrackPopupMenuEx .