Partilhar via


Comandos de menu (C++)

As informações abaixo são organizadas de acordo com as propriedades do menu que aparecem na janela Propriedades quando você seleciona um comando de menu. Elas são listadas em ordem alfabética, embora a janela Propriedades também permita que você exiba essas propriedades por categoria.

Propriedade Descrição
Intervalo Pode ser um destes valores:
- Nenhuma: Sem intervalo. Este é o padrão.
- Coluna: Para menus estáticos, esse valor coloca o comando de menu em uma nova linha.
Para menus pop-up, esse valor coloca o comando de menu em uma nova coluna sem linha divisória entre as colunas.
A configuração dessa propriedade afeta a aparência do menu somente em tempo de execução, não no editor de menu.
- Barra: O mesmo que Coluna , exceto que, para menus pop-up, esse valor separa a nova coluna da coluna antiga com uma linha vertical.
A configuração dessa propriedade afeta a aparência do menu somente em tempo de execução, não no Editor de menu.
Legenda O texto que rotula o comando de menu (o nome do menu). Para tornar uma das letras na legenda de um comando de menu a tecla mnemônica, preceda-a com um símbolo de "&".
Verificada Se True, o comando de menu é inicialmente verificado. Tipo: Bool. Padrão: False.
Ativado Se False, o item de menu será desativado.
Cinzento Se True, o comando de menu está inicialmente acinzentado e inativo. Tipo: Bool. Padrão: False.
Ajuda Alinha o item de menu à direita. Padrão: False.

Por exemplo, o comando do menu Ajuda está sempre à direita em todos os aplicativos do Windows. Se você definir essa propriedade em um item de menu, esse item aparecerá na extrema direita e no final do menu. Aplica-se a itens de nível superior.
Identificação Um símbolo definido no arquivo de cabeçalho. Tipo: Símbolo, inteiro ou cadeia de caracteres entre aspas.

Você pode usar qualquer símbolo que esteja normalmente disponível em qualquer um dos editores, mesmo que a janela Propriedades não forneça uma lista suspensa para você selecionar.
Pop-up Se True, o comando de menu é um menu pop-up. Tipo: Bool. Padrão: True para menus de nível superior em uma barra de menus, caso contrário, False.
Prompt Contém texto para aparecer na barra de status quando este comando de menu é realçado. O texto é colocado na tabela de cadeia de caracteres com o mesmo identificador do comando de menu.

Esta propriedade está disponível para qualquer tipo de projeto, mas a funcionalidade de tempo de execução é específica do MFC.
Justificar da direita para a esquerda Justifica com o botão direito do mouse o comando de menu na barra de menus em tempo de execução. Tipo: Bool. Padrão: False.
Ordem da direita para a esquerda Permite que os comandos de menu sejam exibidos da direita para a esquerda quando a interface estiver localizada para qualquer idioma que leia da direita para a esquerda, como hebraico ou árabe.
Separador Se True, o comando de menu é um separador. Tipo: Bool. Padrão: False.

Associar comandos de menu

Muitas vezes, você deseja que um comando de menu e uma combinação de teclado emitam o mesmo comando de programa. Comandos idênticos são emitidos usando o Editor de menu para atribuir o mesmo identificador de recurso ao comando de menu e a uma entrada na tabela aceleradora do aplicativo. Em seguida, edite a legenda do comando de menu para mostrar o nome da tecla aceleradora.

Para associar um comando de menu a uma tecla aceleradora

  1. No Editor de menus, selecione o comando de menu desejado.

  2. Na janela Propriedades, adicione o nome da chave aceleradora à propriedade Caption :

    • Após a legenda do menu, digite a sequência de escape para uma guia (\t), para que todas as teclas aceleradoras do menu fiquem alinhadas.

    • Digite o nome da tecla modificadora (Ctrl, Alt ou Shift) seguido por um sinal de adição (+) e o nome, letra ou símbolo da chave adicional.

    Por exemplo, para atribuir Ctrl+O ao comando Abrir no menu Arquivo , modifique a legenda do comando de menu para que ela se pareça com o seguinte texto:

    &Open...\tCtrl+O
    

    O comando de menu no Editor de menus é atualizado para refletir a nova legenda à medida que você a digita.

  3. Crie a entrada da tabela aceleradora no editor do Acelerador e atribua-lhe o mesmo identificador que o comando de menu. Use uma combinação de teclas que você acha que será fácil de lembrar.

Seu aplicativo MFC pode exibir texto descritivo para cada um dos comandos de menu que um usuário pode selecionar. Exiba texto descritivo atribuindo uma cadeia de caracteres de texto a cada comando de menu usando a propriedade Prompt na janela Propriedades . Se você tiver uma cadeia de caracteres na tabela de cadeia de caracteres cujo ID é o mesmo que o comando, um aplicativo MFC exibirá automaticamente esse recurso de cadeia de caracteres na barra de status do aplicativo em execução quando um usuário passar o mouse sobre um item de menu.

  • Para associar um comando de menu a uma cadeia de texto da barra de status em aplicativos MFC, no Editor de menu, selecione o comando de menu. Na janela Propriedades, digite o texto da barra de status associada na caixa Prompt .

Em um projeto C++, você pode atribuir uma tecla de acesso (um mnemônico que permite ao usuário selecionar o menu com o teclado) aos seus menus e comandos de menu.

  • Para atribuir uma tecla de acesso (atalho) a um comando de menu, digite um ampersand (&) antes de uma letra no nome do menu ou do comando para especificar essa letra como tecla de acesso correspondente.

    Por exemplo, "&File" define Alt+F como a tecla de atalho para o menu Arquivo em aplicativos escritos para o Microsoft Windows.

    O item de menu fornecerá uma indicação visível de que uma das letras tem uma tecla de atalho atribuída a ela. A letra seguinte ao ampersand aparecerá sublinhada (dependente do sistema operativo).

Observação

Certifique-se de que todas as teclas de acesso em um menu são únicas clicando com o botão direito do rato no menu e escolhendo Verificar Mnemónicos.

Requerimentos

Win32

Ver também

Editor de Menus