Construir menus

Quando se cria um novo banco, 4D cria automaticamente uma barra de menus padrão (Barra de menu #1) incluindo os menus padrões e um comando de retorno ao modo Desenho.

Este mecanismo permite ao usuário acessar ao modo Aplicação assim que o banco é criado. A barra de menus #1 é chamada automaticamente quando o comando Testar aplicação é selecionado no menu Executar.

A barra de menus padrão contém três menus: Arquivo, Edição e Ambiente.

• Arquivo: este menu só inclui o comando Sair. A seleção automática Sair está associada ao comando, o que provoca o fechamento da aplicação.
  Edição (padrão): o menu Edição é padrão e completamente modificável. As funções de edição do tipo copiar, colar, etc. são definidas utilizando ações padrões.
  Ambiente: o menu Ambiente contém por padrão os comandos Voltar ao modo Desenho, o que é utilizado para sair do modo Aplicação.

É possível modificar esta barra de menu como você quiser ou criar barras de menus adicionais.

Esta seção descreve o processo de criação de uma barra de menus personalizada.

Nota: É possível criar barras de menus totalmente por programação. Para maiores informações sobre este ponto, consulte Menus o Manual de Linguagem 4D.

Para criar uma barra de menus:

1. Vá até a página “Menus” da caixa de ferramentas de 4D.
   4D mostra o editor de barras de menus. Por padrão, aparece a barra de menus #1 no painel a esquerda, assim como as outras barras que tenham sido criadas.
   4D atribui seqüencialmente os números de barras de menus, aparece primeiro a barra Barra de Menus #1. É possível renomear as barras de menus mas não é possível mudar os números. Estes números são utilizados pelos comandos de linguagem.
2. Clique no botão adicionar situado debaixo da área de barras de menus.
   Ou
   Selecione o comando Criar uma nova barra de menus no menu contextual da lista ou no menu de opções localizado sob a lista.
   Uma nova barra de menus aparece na lista com os menus padrões (Arquivo e Edição).
3. Faça Alt+clique (Windows) ou Opção+clique (Mac OS) no nome da barra de menus ou clique duas vezes em seu nome a fim de passar ao modo edição e introduzir um nome personalizado (opcional).
   Ou
   Introduza um nome personalizado na área “Título”.
   Um nome personalizado pode facilitar a identificação das barras de menus nas diferentes caixas de diálogo do ambiente Desenho e na linguagem. O nome de uma barra de menus pode ter até 31 caracteres e ser único. Neste momento, você pode começar a modificar as barras de menus ou adicionar menus, comandos aos menus, etc.

É possível criar menus a qualquer momento. Eles podem ser asociados a barras de menus ou a outros menus (sub-menus hierárquicos), ou não associá-los a nenhum elemento e administrá-los somente por programação (menus independentes).

Não é necessário criar os menus na ordem em que aparecerão. Você pode reorganizar os menus depois de criá-los utilizando arrastar e soltar. Para maiores informações, consulte a seção “Reorganizar os menus e as linhas de menus”.

Nota: É possível criar menus totalmente por programação. Para maiores informações, consulte Menus no Manual de Linguagem.

1. Vá à página “Menus” da caixa de ferramentas de 4D.
2. Exiba a página “Menus” da caixa de ferramentas de 4D.  Selecione a etiqueta “Menus” ou um menu existente na lista dos menus fonte e clique no botão.
   Ou
   Escolha o comando Criar um novo menu no menu contextual (clique no título “Menus” ou em um menu existente) ou no menu opções do editor.
   4D adiciona um novo menu ao final da lista.
3. Alt+clique (Windows) ou Opção+clique (Mac OS) no nome do menu ou clique nele para passar ao modo editável e introduzir um nome personalizado.
   Ou
   Introduza um nome personalizado na área “Título”.
   É possível introduzir o nome do menu diretamente ou introduzir uma referência a uma variável, fonte ou elemento XLIFF. Para maiores informações sobre este ponto, consulte Utilizar uma referência para um título.
   Se você digita diretamente o nome, evite os caracteres de controle que podem afetar a visualização do menu (ver o parágrafo “Caracteres de controle nas etiquetas de menus”).
4. Repita os passos 2 e 3 para adicionar mais menus (opcional).
   É possível pré-visualizar um menu enquanto você o cria selecionando o menu fonte e clicando na área de visualização na parte direita do editor.

Para cada menu, você debe criar os comandos de menus que aparecem quando os menus são exibidos. É possível inserir linhas que serão associadas com métodos ou ações padrões, ou associar outros menus (sub-menus). A associação de sub-menus hierárquicos é descrita em Associar menus.

Para adicionar um comando de menu:

1. Na lista de menus fonte, selecione o menu ao qual você quer adicionar um comando.
   Se o menu já tem comandos, serão exibidos na lista central. Se você deseja inserir o novo comando, selecione o comando que você quer que apareça acima dele.  É possível reordenar o menu depois.
2. Escolha Adicionar linha ao menu “NomeMenu” no menu de opções do editor ou no menu contextual (clique com o botão direito na lista central).
   Ou
   Clique no botão de adicionar localizado debaixo da lista central..
   4D adiciona uma nova linha e a nomeia, por padrão, como “Linha X” onde X é o número de elementos criados.
3. Pressione Alt+clique (Windows) ou Opção+clique (Mac OS) ou clique duas vezes no nome do comando para passar ao modo edição e introduzir uma etiqueta personalizada.
   Ou
   Introduza um nome personalizado na área “Título”.
   É possível introduzir o nome do menu diretamente ou introduzir uma referência a uma variável, fonte ou elemento XLIFF. Para maiores informações, consulte o parágrafo Utilizar uma referência para um título. Se você introduz o nome diretamente, você deve evitar o caracteres de controle que podem afetar a visualização do comando de menu (ver o parágrafo a seguir).
4. (Opcional) – Introduza uma referência personalizada na área “Referência”.
   Esta referência pode ser utilizada pelos comandos de linguagem. Para maiores informações, consulte Personalizar parâmetros.
5. Repita os passos de 1 a 4 para adicionar outros comandos.

É possível definir as propriedades dos comandos de menus utilizando caracteres de controle (metacaracteres) diretamente nas etiquetas de comandos de menus. Por exemplo, você pode atribuir ao atalho de teclado Ctrl+G (Windows) o Comando+G (Mac+OS) a um comando de menu colocando os caracteres “/G” na etiqueta do elemento de menu.

Os caracteres de controle não aparecem nas etiquetas dos comandos de menus. Portanto, você deve utilizá-los de modo que não surjam efeitos indesejáveis.

• ( (abrir parênteses)
• < (menor que)
• ! (signo de admiração)
• ^ (acento circunflexo)
• / (barra diagonal)

Para maiores informações sobre o uso destes caracteres, consulte a descrição do comando APPEND MENU ITEM no Manual de Linguagem 4D.

Uma vez que você tenha criado os menu de uma barra de menus e seus comandos de menus, pode sem reorganizados usando arrastar e soltar. Para inserir um comando de menu em um novo lugar, simplesmente arraste-os até sua nova localização na lista de menus. Para mover um menu a uma nova localização, simplesmente arraste-o a outra localização na lista de menus.

É possível excluir uma barra de menus, um menu ou um elemento de menu a qualquer momento. Note que cada menu ou barra de menu tem somente uma referência. Quando um menu é associado a diferentes barras ou a diferentes menus (ver Associar menus), qualquer modificação ou eliminação efetuada neste menu é informada imediatamente em todas instâncias deste menu.

Para excluir uma barra de menus, um menu ou uma linha de menus, você tem duas possibilidades:

• selecionar o elemento a ser excluído e clicar no botão de eliminação localizado debaixo da lista.
• utilize os comandos “Excluir a barra de menus”, “Excluir o menu” ou “Excluir o comando de menu” no menu contextual ou o menu de opções do editor.

Nota: Não é possível excluir a barra de menus #1.