4D Doc Center : INPUT FORM

4D v14.3

INPUT FORM


INPUT FORM ( {tabela ;} formulario {; formUsuario}{; *} )

tabela	Tabela	Table for which to set the input form, or Default table, if omitted
formulario	cadeia	Name of the form to set as input form
formUsuario	cadeia	Name of user form to use
*		Automatic window size

Descrição

O comando FORM SET INPUT define o formulario de entrada atual de tabela para form ou userForm. O formulario deve pertencer a tabela.

O alcance de este comando é o processo atual. Cada tabela tem seu próprio formulario de entrada em cada processo.

Nota: por razões estruturais, este comando não é compatível com formulários de projetos. Se passar um formulário de projeto em form, o comando não faz nada.

FORM SET INPUT não mostra o formulario; só atribui qual formulário é utilizado para a entrada de dados, importação, ou operação por outro comando. Para maior informação sobre a criação de formulários, consulte o .

O formulário de entrada por padrão para cada tabela é definido na janela do Explorador. Este formulário de entrada padrão é utilizado se o comando FORM SET INPUT não é utilizado para especificar um formulario de entrada, ou se especifica um formulário que não existe.

O parâmetro opcional formUsuario lhe permite especificar um formulário usuário (proveniente de form) como formulário de entrada padrão. Se passa um nome de formulário usuário correto, este formulário será utilizado automaticamente em lugar do formulário de entrada no processo atual. Isto lhe permite ter simultâneamente diferentes formulários usuários personalizados (gerados utilizando o comando CREATE USER FORM) e utilizar aquele que seja conveniente em função do contexto.

Para maior informação sobre formulários de usuário, consulte a seção .

Os formulários de entrada são mostrados por numerosos comandos, os quais geralmente são utilizados para permitir ao usuário introduzir novos dados ou modificar dados antigos. Os sguintes comandos mostram um formulário de entrada para entrada de dados ou pesquisas:

Os comandos DISPLAY SELECTION e MODIFY SELECTION mostram uma lista de registros utilizando o formulário de saída. O usuário pode realizar duplo clique em um registro na lista e é mostrado o formulário de entrada.

Os comandos de importação IMPORT TEXT, IMPORT SYLK e IMPORT DIF utilizam o formulário de entrada atual para importar registros.

O parâmetro opcional * é utilizado em conjunto com as propriedades do formulário que definiu na janela de propriedades do formulário do ambiente Desenho e o comando Open window. Ao especificar o parâmetro * lhe indica a 4D que utilize as propriedades do formulário para redimensionar automaticamente a janela para o uso do formulário a seguir (como um formulário de entrada ou como uma caixa de diálogo). Ver maior informação em Open window.

Nota: passe ou não o parâmetro opcional * ou não, FORM SET INPUT muda o formulario de entrada para a tabela.

Exemplo 1

O exemplo a seguir mostra um uso típico de FORM SET INPUT:

 FORM SET INPUT([Empresas];"Nova empresa") ` Formulário para adicionar novas empresas

 ADD RECORD([Empresas]) ` Adicionar uma nova empresa

Exemplo 2

Em um banco de faturação que administre várias empresas, a criação de uma fatura deve ser efetuada utilizando o formulário usuário correspondente:

 Case of

    :(empresa="4D SAS")

       FORM SET INPUT([Faturas];"Entrada";"4D_SAS")

    :(empresa="4D Inc")

       FORM SET INPUT([Faturas];"Entrada";"4D_Inc")

    :(empresa="Acme")

       FORM SET INPUT([Faturas];"Entrada";"ACME")

 End case

 ADD RECORD([Faturas])