Partilhar via


Comandos de menu (C++)

As informações abaixo são organizadas de acordo com as propriedades de 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 pela categoria.

Propriedade Descrição
Break Pode ser um destes valores:
- Nenhuma: sem interrupção. Esse é 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 uma linha divisória entre as colunas.
Definir essa propriedade afeta a aparência do menu somente em tempo de execução, não no editor de menus.
- Barra: igual a Coluna, exceto que, para menus pop-up, esse valor separa a nova coluna da coluna antiga com uma linha vertical.
Definir essa propriedade afeta a aparência do menu somente em tempo de execução, não no Editor de Menus.
Legenda O texto que rotula o comando de menu (o nome do menu). Para fazer com que uma das letras na legenda de um menu comande a tecla mnemônica, preceda-a com um e comercial (&).
Verificado Se True, o comando de menu será inicialmente verificado. Tipo: Bool. Padrão: falso.
Enabled Se False, o item de menu será desabilitado.
Cinza Se True, o comando de menu será inicialmente esmaecido e inativo. Tipo: Bool. Padrão: falso.
Ajuda Alinha o item de menu à direita. Padrão: falso.

Por exemplo, o comando de menu Ajuda está sempre à direita em todos os aplicativos do Windows. Se você definir essa propriedade em um item de menu, esse item aparecerá bem à e no final do menu. Aplica-se a itens de nível superior.
ID 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.
Popup 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 a ser exibido na barra de status quando este comando de menu é realçado. O texto é colocado na tabela de cadeia de caracteres com o mesmo identificador que o comando de menu.

Essa 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 o comando de menu à direita na barra de menus em tempo de execução. Tipo: Bool. Padrão: falso.
Ordem da direita para a esquerda Permite que os comandos de menu sejam exibidos da direita para a esquerda quando a interface for localizada em qualquer idioma que leia da direita para a esquerda, como hebraico ou árabe.
Separador Se True, o comando de menu será um separador. Tipo: Bool. Padrão: falso.

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 Menus para atribuir o mesmo identificador de recurso ao comando de menu e a uma entrada na tabela de acelerador do aplicativo. Então você edita a Legenda do comando de menu para mostrar o nome da chave de acelerador.

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 de acelerador à propriedade Caption:

    • Após a legenda do menu, digite a sequência de escape para uma guia (\t), para que todas as teclas de acelerador 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 se pareça com o seguinte texto:

    &Open...\tCtrl+O
    

    O comando de menu no Editor de Menus é atualizado para refletir a nova legenda conforme você digita.

  3. Crie a entrada acelerador-tabela no editor do Acelerador e atribua o mesmo identificador que o comando de menu. Use uma combinação de teclas que você considera 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 o 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 cuja ID é a mesma 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 cursor do mouse sobre um item de menu.

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

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

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

    Por exemplo, "&Arquivo" 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 leta após o e comercial será exibida sublinhada (dependendo do sistema operacional).

Observação

Verifique se todas as teclas de acesso em um menu são exclusivas clicando com o botão direito do mouse em seu menu e escolhendo Verificar Mnemônico.

Requisitos

Win32

Confira também

Editor de Menu