FORM Convert to dynamic
FORM Convert to dynamic ( {Tabela ;} nomeForm ) : Object
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| Table | Table | → | Tabela formulário |
| nomeForm | Text | → | Nome do formulário "clássico" projeto ou tabela |
| Resultado | Object | ← | nomeForm é convertido a um formulário dinâmico |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando FORM Convert to dynamic converte o nomeFormulario (formulário clássico) a um formulário dinâmico e o devolve em um objeto.
Os formulários clássicos são formulários 4D armazenados dentro do arquivo de estrutura em formato binário. Os formulários dinâmicos são formulários cujas estruturas são definidas em um objeto 4D (ou um arquivo .json). Para saber mais, consulte Formulários Dinâmicos .
Se quiser converter um formulário de tabela, passe a tabela de formulário no parâmetro tabela e depois passe seu nome como uma string em nomFormulario. Para um formulário de projeto, passe o nome do formulário diretamente em nomeFormulario.
Para poder executar o formulário diretamente passando o objeto resultante ao comando DIALOG, FORM Convert to dynamic aplica regras específicas ao converter o formulário:
- As referências ao método de formulário e aos métodos de objeto de formulário são ignoradas. Deve associar os nomes dos métodos de projeto para chamar a cada evento de formulário gerenciado.
- As referências a listas são exportadas por nome ao invés de um ponteiro JSON que faz referência ao arquivo lists.json.
- As referências aos filtros com nome e aos formatos de visualização com nome (utilizando o caractere prefixo '|') são exportados por valor ao invés de um ponteiro JSON que faz referência ao arquivo filters.json.
- Dado que as imagens da biblioteca de imagens não são exportadas pelo comando, os objetos que fazem referência a uma imagem da biblioteca de imagens ainda fazem referência à biblioteca depois da conversão. Em sua propriedade "icon", utilizam uma url "pictlib: xx" especial, onde xx é o ID na biblioteca.
As imagens estáticas são convertidas como propriedades objeto tipo imagem. - Objetos obsoletos são ignorados. Veja o parágrafo para ver a lista de objetos ou propriedades que não são compatíveis com formulários dinâmicos.
Nota: as referências ao método de formulário e os métodos objeto de formulário são exportadas com identificadores internos, que serão válidos apenas no banco de dados atual enquanto que os métodos nomeFormulario não são modificados. Se quiser utilizar o formulário exportado em outro contexto, deve atribuir nomes de método de projeto à propriedade "método" do formulário ou objeto de formulário (ver exemplo).
Exemplo
Se quiser converter um formulário clássico, modificá-lo e mostrá-lo.
O formulário original:
var $dynForm : Object
$dynForm:=FORM Convert to dynamic("FormToConvert")
$dynForm.pages[1].objects.TitleArea.stroke:="red"
$dynForm.pages[1].objects.bOK.method:="myMethod" //associa a um método de projeto
DIALOG($dynForm)
Se executar o código:
