4D Doc Center : EDIT FORM

4D v14.3

EDIT FORM


EDIT FORM ( tabela ; formulario {; formUsuario {; biblioteca}} )

Parâmetro	Tipo	Descrição
tabela	Tabela	Tabela do formulário a modificar
formulario	cadeia	Nome do formulário tabela a modificar
formUsuario	cadeia	Nome do formulário de usuário a modificar
biblioteca	cadeia	Rota completa de objeto usável da biblioteca

Descrição

O comando EDIT FORM abre o formulário de tabela definido pelos parâmetros tabela, formulario e o parâmetro opcional formUsuario no editor de formulários de usuário :

Nota: a janela do editor abre apenas se for a primeira janela do processo. Em outras palavras, geralmente será necessário abrir um novo processo para mostrar o editor.

Se passa uma cadeia vazia no parâmetro formUsuario e se não houver um formulário de usuário que já esteja relacionado a formulario, o formulário fonte é mostrado no editor. O formulário modificado é copiado então no arquivo de estrutura de usuário (.4DA) e será utilizado como um substituto de formulario.

Se um formulário de usuário já tiver sido gerado a partir de formulario utilizando este comando, o formulário usuário é mostrado no editor. Se deseja começar desde o formulário fonte, primeiro deve eliminar o formulário de usuário utilizando o comando DELETE USER FORM.

O parâmetro formUsuario permite definir um formulário de usuário (criado utilizando o comando CREATE USER FORM) a modificar. Neste caso, o formulário se mostra no editor.

No parâmetro opcional biblioteca, passe a rota de acesso completa da biblioteca de objetos que o usuário estará autorizado a utilizar para personalizar o formulário. Quando são utilizadas com o editor de formulários de usuário, as bibliotecas de objetos permitem pegar objetos com suas propriedades gráficas e suas ações automáticas. Os objetos com métodos não aparecem na biblioteca. Atenção, o desenvolvedor deve verificar que a adição dos objetos de uma biblioteca seja compatível com o formulário de usuário (e seus objetos) a nível de nomes, variáveis e tipos.

Em modo cliente/servidor, a biblioteca deve ser encontrada na pasta Resources do banco, no mesmo nível da pasta Plugins, de maneira que esteja disponível para todas as máquinas clientes. Se a biblioteca for válida, é aberta desde a janela do formulário.

Para maior informação sobre a biblioteca de imagens, consulte o Manual de Desenho.

Exemplo

Neste exemplo, o usuário pode escolher uma biblioteca e depois modificar um formulário de diálogo:

 MAP FILE TYPES("4DLB";"4IL";"Biblioteca 4D")

 $vABib:=Select document(1;"4DLB";"Por favor selecione uma biblioteca";0)

 If(OK=1)

  `Uma biblioteca foi escolhida

    $vARotaBib:=Document

 Else

    $vARotaBib:=""

 End if

 

 EDIT FORM([Dialogos];"Bemvindo";"Lib_Logos.4il")

 If(OK=1)

  `Apresentação do formulário modificado

    DIALOG([Dialogos];"Bemvindo")

 End if

Variáveis e conjuntos do sistema

Se o usuário salva as modificações ao formulário, a variável OK assume o valor 1. Em caso de erro, OK assume o valor 0.

Gestão de erros

Um erro é gerado se:

o formulário não foi declarado editável pelo usuário no ambiente de Desenho ou ele não existe
o formulário já está aberto e sendo modificado em outro processo,
o usuário não pode acessar o formulário porque ele não tem os direitos de acesso necessários.
Você pode interceptar esse erro com um método de gestão de erros instalado com o comando ON ERR CALL.