4D Doc Center : Formulários Herdados

4D v14.3

Formulários Herdados

4D permite utilizar “formulários herdados”. O princípio dessa função consistente em poder usar objetos de um formulário A em um formulário B: o formulário B "herda" os objetos do formulário A.

Suponhamos por exemplo que todos os formulários de entrada de um banco devam ter os botões Ok, Cancelar, Próximo e Anterior e um logo. Simplesmente crie um formulário que contenha apenas esses elementos e depois use-o como um formulário herdado em todos os formulários de entrada do banco. Cada formulário de entrada contém apenas os campos e objetos específicos para seu uso.

Diferente dos "modelos" definidos no assistente de formulários (consulte Criar um modelo de formulário), a referência a um formulário herdado sempre permanece ativa: se um dos elementos do formulário herdade é mudado (por exemplo o estilo ou posição dos botões), todos os formulários que utilizam esse elemento também serão automaticamente modificados.

Os formulários herdados são compatíveis com os formulários tabela e formulários projeto.

Como funciona

Durante o uso do banco, os objetos do formulário herdado são combinados dinamicamente com os objetos do formulário aberto. Esse mecanismo é muito similar aos mecanismos da "página 0" dos formulários, a diferença é que um formulário herdado pode ser aplicado ao conjunto de formulários do banco.

Quando um formulário é executado, os objetos são carregados e combinados na seguinte ordem:

Página zero do formulário herdado
Página 1 do formulário herdado
Página zero do formulário aberto
Página atual do formulário aberto.

Esta ordem determina a ordem de entrada de objetos no formulário.

Nota: apenas as páginas 0 e 1 do formulário herdado podem aparecer em outros formulários.

As propriedades (nome da janela, redimensionamento, eventos, etc.) e os métodos de um formulário herdado não são levados em consideração quando usados como um formulário herdado. Por outro lado, são chamados os métodos de objetos que contém.

Definir um formulário herdado

Se deseja definir um formulário como herdado, deve utilizar o editor de formulários 4D.

Para definir um formulário herdado:

No editor de formulários, abra o formulário onde deseja utilizar o formulário herdado.
Exiba a Lista de propriedades e clique fora de todos os objetos do formulário para visualizar as propriedades do formulário.
As listas "Tabela de formulário herdado" e "Nome de formulário herdado" estão disponíveis. Nessas listas aparecem todas as tabelas de seu banco de dados e seus formulários.
Selecione a tabela e o nome do formulário a herdar. Para herdar de um formulário projeto, selecione <Nenhum> na lista "Tabela do formulário herdado".

Todos os formulários podem ser atribuidos como formulário herdado. Entretanto, os elementos do formulário devem ser compatíveis com a utilização das diferentes tabelas do banco de dados.

Depois de selecionar o formulário herdado, seu conteúdo aparece na janela atual do editor de formulários. Aparece apenas como "visualização prévia", e não é possível selecionar ou modificar um objeto nesse formulário. Para fazer isso, deve abrir o formulário em sua própria janela.

Pode ocultar os objetos de um formulário herdado desmarcando a opção Formulário herdado no submenu Mostrar do menu Formulário ou no menu contextual do editor.

Para não utilizar mais um formulário como formulário herdado, selecione a opção <Nenhum> na Lista de propriedades.

Nota: é possível definir um formulário herdado em um formulário que se utilizará como formulário herdado de um terceiro formulário. A combinação dos objetos são efetuados de maneira recursiva. 4D detecta loops recursivos (por exemplo, se o formulário [tabela1]formulario1 está definido como formulário herdado de [tabela1]formulario1, ou seja, tem o mesmo nome) e interrompe a cadeia de formulários.