4D v14.3

EDIT FORM

Página Inicial

 
4D v14.3
EDIT FORM

EDIT FORM 


 

EDIT FORM ( tabela ; formulario {; formUsuario {; biblioteca}} )  
Parâmetro Tipo   Descrição
tabela  Tabela in Tabela do formulário a modificar
formulario  cadeia in Nome do formulário tabela a modificar
formUsuario  cadeia in Nome do formulário de usuário a modificar
biblioteca  cadeia in Rota completa de objeto usável da biblioteca

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

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.

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.

 
PROPRIEDADES 

Produto: 4D
Tema: Formulários de usuário
Número 807

Este comando modifica a variável sistema OKEste comando modifica a variável sistema Error

 
HISTÓRIA 

Criado por: 4D 2004

 
VER TAMBÉM 

CREATE USER FORM
DELETE USER FORM
Introdução aos formulários de usuário
LIST USER FORMS

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)