Editor de menu (C++)

Os menus permitem-lhe organizar os comandos de uma forma lógica e fácil de encontrar. Com o Editor de menus, você pode criar e editar menus trabalhando diretamente com uma barra de menus que se assemelha muito à do seu aplicativo concluído.

Como Fazer

O Editor de Menus permite-lhe:

Para criar um menu padrão

1. Vá para o menu Vista>Modo de Exibição de Recursos ou Vista>Outras Janelas>Modo de Exibição de Recursos e clique com o botão direito do mouse no cabeçalho Menu. Escolha Adicionar Recurso e, em seguida, Menu.

2. Selecione a caixa Novo Item (o retângulo que contém Digite aqui) na barra de menus.

   
   Caixa de Item Novo

3. Digite um nome para o novo menu, por exemplo, Arquivo.

   O texto digitado aparece no Editor de menu e na caixa Legenda na janela Propriedades. Você pode editar as propriedades do novo menu em qualquer local.

   Depois de dar um nome ao novo menu na barra de menus, a caixa de novo item muda para a direita (para permitir que você adicione outro menu). Outra caixa de novo item é aberta abaixo do seu primeiro menu para que você possa adicionar comandos de menu a ele.

   
   Caixa Novo Item com o foco deslocado depois de digitar o nome do menu

   Observação

   Para criar um menu de item único na barra de menus, defina a propriedade Popup como False.

Para criar um submenu

1. Selecione o comando de menu para o qual você deseja criar um submenu.

2. Na caixa Novo Item que aparece à direita, digite o nome do novo comando de menu. Este novo comando aparecerá primeiro no menu do submenu.

3. Adicione mais comandos de menu ao menu de submenus.

Para inserir um novo menu entre menus existentes

Selecione um nome de menu existente e pressione a tecla Inserir ou clique com o botão direito do mouse na barra de menus e escolha Inserir novo.

A caixa Novo Item é inserida antes do item selecionado.

Para adicionar comandos a um menu

1. Crie um menu. Em seguida, selecione um nome de menu, por exemplo, Arquivo.

   Cada menu expandirá e exporá uma nova caixa de item para comandos. Por exemplo, você pode adicionar os comandos New, Open e Close a um menu File .

2. Na caixa novo item, digite um nome para o novo comando de menu.

   Observação

   O texto digitado aparece no Editor de menu e na caixa Legenda na janela Propriedades. Você pode editar as propriedades do novo menu em qualquer local.

   Sugestão

   Você pode definir uma chave mnemônica (tecla de atalho) que permite ao usuário selecionar o comando de menu. Digite um símbolo de ampersand (&) antes de uma letra para especificá-la como mnemónica. O usuário pode selecionar o comando de menu digitando essa letra.

3. Na janela Propriedades , selecione as propriedades do comando de menu que se aplicam. Para obter detalhes, consulte Propriedades do comando de menu.

4. Na caixa Prompt na janela Propriedades , digite a cadeia de caracteres de prompt que você deseja que apareça na barra de status do aplicativo.

   Esta etapa cria uma entrada na tabela de cadeia de caracteres com o mesmo identificador de recurso que o comando de menu que você criou.

   Observação

   Os prompts só podem ser aplicados a itens de menu com uma propriedade Popup de True. Por exemplo, os itens de menu de nível superior podem ter indicações se tiverem itens de submenu. O objetivo de um prompt é indicar o que acontecerá se um usuário selecionar o item de menu.

5. Pressione Enter para concluir o comando de menu.

   A caixa do novo item é selecionada para que você possa criar mais comandos de menu.

Para selecionar vários comandos de menu para executar operações em massa, como excluir ou alterar propriedades

Enquanto mantém pressionada a tecla Ctrl , selecione os comandos de menus ou submenus desejados.

Para mover e copiar menus e comandos de menu

• Use o método de arrastar e soltar:

  1. Arraste ou copie o item para o qual deseja mover:

     • Um novo local no menu atual.

     • Um menu diferente. Você pode navegar para outros menus arrastando o ponteiro do mouse sobre eles.

  2. Quando o guia de inserção mostrar a posição desejada, solte o comando de menu.

• Use comandos de menu de atalho:

  1. Clique com o botão direito do rato num ou mais menus ou comandos de menu e, em seguida, selecione Recortar (para mover) ou Copiar.

  2. Se você estiver movendo os itens para outro recurso de menu ou arquivo de script de recurso, abra-o em outra janela.

  3. Selecione a posição do menu ou comando de menu para o qual deseja mover ou copiar.

  4. No menu de atalho, escolha Colar. O item movido ou copiado é colocado antes do item selecionado.

Para excluir um menu ou comando de menu

Clique com o botão direito do mouse no nome do menu ou comando e escolha Excluir.

Pop-up Menus

Os menus pop-up exibem comandos usados com freqüência. Eles podem ser sensíveis ao contexto para a localização do ponteiro. Usar menus pop-up em seu aplicativo requer a criação do próprio menu e, em seguida, conectá-lo ao código do aplicativo.

Depois de criar o recurso de menu, o código do aplicativo precisa carregar o recurso de menu e usar TrackPopupMenu para fazer com que o menu apareça. Uma vez que o usuário tenha descartado o menu pop-up, selecionando fora dele, ou tenha selecionado um comando, essa função retornará. Se o usuário escolher um comando, essa mensagem de comando será enviada para a janela cujo identificador foi passado.

• Para criar um menu pop-up, crie um menu com um título vazio e não forneça uma legenda. Em seguida, adicione um comando de menu ao novo menu. Vá para o primeiro comando de menu abaixo do título do menu em branco (tem a legenda temporária Digite aqui) e digite uma legenda e qualquer outra informação.

  Repita este processo para quaisquer outros comandos de menu no menu pop-up e certifique-se de salvar o recurso de menu.

• Para conectar um menu pop-up ao seu aplicativo, por exemplo, adicione um manipulador de mensagens para WM_CONTEXTMENU e, em seguida, adicione o seguinte código ao manipulador de mensagens:

  CMenu menu;
  VERIFY(menu.LoadMenu(IDR_MENU1));
  CMenu* pPopup = menu.GetSubMenu(0);
  ASSERT(pPopup != NULL);
  pPopup->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON, point.x, point.y, AfxGetMainWnd());
  

  Observação

  O CPoint passado pelo manipulador de mensagens está em coordenadas de tela.

Normalmente, quando você está trabalhando no Editor de menus, um recurso de menu é exibido como uma barra de menus. No entanto, você pode ter recursos de menu que são adicionados à barra de menus do aplicativo enquanto o programa está em execução.

• Para exibir um recurso de menu como um menu pop-up, clique com o botão direito do mouse no menu e escolha Exibir como pop-up.

  Esta opção é apenas uma preferência de visualização e não modificará o seu menu.

Requerimentos

Win32

Ver também

Editores de Recursos
Comandos de menu
User-Interface objetos e IDs de comando
Ementas
Ementas