Gestão de métodos

Os métodos são criados utilizando o editor de métodos. Este editor permite criar, testar e modificar qualquer tipo de método.

Esta seção descreve os diferentes modos de criação e abertura de métodos (métodos de objeto, métodos de projeto, triggers e métodos de formulário).

Lembre-se que em todas as aplicações já são criados métodos de bancos vazios; você só deve abri-los a partir do Explorador.

Nota 4D Server: O bloqueio de um objeto ocorre quando dois ou mais usuários tentam modificar o mesmo método ao mesmo tempo. Se um usuário abre um método
no ambiente Desenho, o método é bloqueado. Os outros usuários não podem modificar este método até que o primeiro usuário o libere fechando a janela. Entretanto, é possível abrir o método em modo somente leitura com a finalidade de ler ou copiar certos elementos do método.

Os métodos de objeto são criados para um objeto de um formulário. Para começar, você deve ir ao editor de formulários, com um formulário em tela.

Para criar ou abrir um método de objeto no editor de formulários:

No editor de formulários, mantenha pressinada a tecla Alt (Windows) ou a tecla Opção (Mac OS) e clique no objeto
Ou
Selecione o objeto e logo escolha o comando Método de Objeto do menu Objeto.
Ou
Clique com o botão direito no objeto e escolha Método do objeto no menu contextual.
Ou
Na lista de propriedades, clique no botão Editar...

Aparece uma janela do Janela do editor de métodos, a janela estará vazia se você acaba de criar o método.

É possível criar ou abrir um método de projeto de várias formas.

Para criar um método de projeto a partir do menu Arquivo:

1 - Escolha Novo > Método... no menu Arquivo ou utilizando o botão Novo da barra de ferramentas de 4D.
4D exibe a caixa de diálogo Novo método.

2 - Introduza um nome de método.
Os nomes de métodos podem ter até 31 caracteres, incluindo letras, números, espaços e o caractere traço inferior (ver Convenções en el manual de Lenguaje de 4D)..

3 – (Opcional) Selecione uma pasta para armazenar o método.
Se você selecionar um nome de pasta, o método será localizado nesta pasta.
As pastas podem ser utilizadas para organizar os objetos de sua aplicação e são administrados na páginaPágina Início do Explorador. Por padrão, o método é criado no Nível superior, ou seja, fora das pastas.

4 – Clique no botão OK.
4D abre uma janela vazia do editor de métodos onde você pode começar a escrever um novo método.

Escolha Abrir > Método... no menu Arquivo.

Aparece a página  Página Início do Explorador (ver abaixo).

• No  Editor de menus, clique na área “Nome do método” de um elemento da barra de menus atual

Esta área contém o nome do método associado ao elemento selecionado (caso não exista).

• Clique no botão de edição a direita do menu “Nome do método”

O método é exibido em uma nova janela do editor de métodos.

É possível criar um trigger utilizando um atalho no Editor de estrutura ou diretamente no Explorador.

Para criar ou abrir um trigger a partir da janela do Editor de estrutura:

1 – Mantenha pressionada a tecla Alt (Windows) ou a tecla Opção (Mac OS) e faça um clique duplo no título da tabela na janela do editor de estrutura.
Ou
Na janela do editor que exibe a Propriedades de Tabela, clique no botão Editar...

Aparece uma janela  Janela do editor de métodos, vazia se você acaba de criar o trigger:

Para criar ou abrir um trigger a partir do Explorador:
1 – Exiba  a Current form tableda janela do Explorador e exiba o elemento “Triggers”.
2 – Selecione a tabela que lhe interessa e clique no botão situado mais abaixo da lista.
Ou
Faça um clique duplo na tabela que lhe interessa.
Aparece o trigger em uma janela do Janela do editor de métodos.

Os métodos de formulários podem ser abertos a partir da Current form table do Explorador ou a partir do Editor de formulários..

Para criar ou abrir um método de formulário a partir do Explorador:
1 – Vá a página Current form tabledo Explorador.
2 – Expanda o elemento “Métodos de formulário de projeto” ou “Métodos de formulários de tabela”, dependendo do tipo de formulário que você queira abrir o método.
3 – (Somente formulários de tabela): exibe a tabela a qual pertence o formulário.
4 – Selecione o formulário no qual que você deseja abrir o método.
5 – Clique no botão localizado mais abaixo da lista.
Ou
Faça um duplo clique no nome do formulário.

O método de formulário aparece em uma janela do Janela do editor de métodos.

Nota: Também é possível criar ou abrir um método de formulário a partir da  Página Formulários do Explorador: clique com o botão direito no nome do formulário e escolha Modificar método do formulário... no menu contextual.

Para criar ou abrir um método de formulário a partir do editor de formulários:

1 – Escolha o comando Método de formulário no menu Formulário.
Ou
Clique com o botão direito em uma área vazia no formulário e escolha Método do formulário no menu contextual.
Ou
Na Lista de propriedades, clique no botão Editar... localizado junto a linha Método de formulário.
O método de formulário aparece em uma janela do Janela do editor de métodos.

É possível excluir a qualquer momento um trigger, método de formulário ou de projeto utilizando o Explorador. Também é possível excluir um método de objeto usando o editor de formulários.

Não é possível excluir métodos de banco de dados. Para desativar este tipo de método, apague todas as instruções no método ou as passe como comentários  utilizando o símbolo “//’” (utilizado para diferenciar os comentários do código executável). Para maiores informações sobre comentários em métodos, consulte o parágrafo .

Para excluir um método de formulário, um método de projeto ou um trigger utilizando o Explorador:
1 -  No explorador, vá até Current form table.
Tenha certeza que a página Métodos esteja bem, porque certas opções de exclusão são irreversíveis.

2 – Na janela do Explorador expanda o tipo de método que corresponda ao método que você deseja excluir (Métodos de formulário projeto, Métodos de formulários tabela, Triggers ou Métodos de projeto).

3 – Selecione o nome da tabela ou do formulário ao qual o método que você quer excluir esteja associado.
Ou
Selecione o nome do método de projeto que você deseja excluir.
4D exibe o método no editor de métodos.

4 – Clique no botão excluir localizado na parte inferior da janela do Explorador.

Nota Para excluir um método de projeto, também é possível clicar com o botão direito no nome do método de projeto ou escolher Excluir método no menu contextual.

• Se você excluir um método de formulário ou um trigger, 4D mostra uma mensagem de alerta lhe pedindo para confirmar a operação. Esta eliminação será definitiva.
• Se você excluir um método de projeto, 4D efetua a operação diretamente. Entretanto, essa exclusão não é definitiva (desde que não se esvazie a lixeira). Para maiores informações, consulte o parágrafo Página Lixeira).

É possível excluir métodos de objeto utilizando o editor de formulários. Em alguns casos, excluir os métodos de objeto desnecessários pode fazer com que a execução de banco de dados seja mais rápida.
Para excluir um método

1. Vá ao formulário que contém o(s) método(s) que você quer excluir.
2. Selecione o(s) objeto(s) que estão associado(s) aos métodos de objeto que você quer excluir.
3. Escolha o comando Excluir método do objeto do menu Objeto.

4D exclui os métodos de objeto dos objetos selecionados. 

Nota: Se você excluir um método de objeto por equivocação, selecione Desfazer no menu Edição.

É possível importar e exportar métodos de banco, triggers, projeto, e objeto, em forma de arquivos. Essas funções são acessíveis através dos comandos do menu Método da  Janela do editor de métodos. 

• Quando selecionar o comando Exportar método... aparece uma caixa de diálogo padrão de salvar arquivos, permitindo que corrija o nome, localização e formato do arquivo a ser exportado(ver mais adiante). Do mesmo modo que a impressão, a exportação não considera o estado contraído das estruturas de código, a totalidade do código é exportada.
• Quando selecionar o comando Importar método... aparece uma caixa de diálogo padrão de abrir archivos, permitindo escolher o arquivo a ser importado.
  A importação substitui o texto selecionado no método. Para substituir um método existente por um método importado, selecione todo o conteúdo do método antes de realizar a importação.

A função importar/exportar é multiplataforma: um método exportado em Mac OS pode ser importardo em Windows e vice-versa; 4D se encarrega da conversão de caracteres quando seja necessário.

4D pode exportar e importar os métodos em dois formatos:

• Método 4D (extensão “.c4d” sob Windows): neste formato, os métodos são exportados em forma codificada. Os nomes dos objetos são transformados em referências (tokenized).
  Este formato é utilizado particularmente para fazer um intercâmbio de métodos entre aplicações 4D e plug-ins em diferentes linguagens. Mas não é possível visualizá-los em um editor de texto.
• Texto (extensão “.txt” ): neste formato, os métodos são exportados somente em formato texto. Neste caso, os métodos são perfeitamentes legíveis utilizando um editor de texto padrão. Entretanto, é necessário que as linguagens das aplicações 4D utilizadas para exportar e importar sejam idênticos.
  Nota: Como padrão, desde 4D v15, todas as versões de 4D partilham a mesma linguagem e as mesmas configurações de entrada para números reais e datas, o que facilita partilhamento de código entre desenvolvedores usando copiar/colar ou exportando métodos. Ainda é possível usar configurações locais (como nas versões prévias de 4D) marcando a opção Use regional system settings nas preferências de 4D (veja Página Métodos).