FORM SET INPUT

4D v16.3

FORM SET INPUT


FORM SET INPUT ( {tabla ;} form {; formUsuario}{; *} )

Parámetro	Tipo	Descripción
tabla	Tabla	Tabla para la cual definir el formulario de entrada o Tabla por defecto, si se omite
form	Cadena	Nombre del formulario a definir como formulario de entrada
formUsuario	Cadena	Nombre del formulario usuario a utilizar
*		Tamaño de ventana automático

Descripción

El comando FORM SET INPUT define el formulario de entrada actual de tabla para form o userForm. El formulario debe pertenecer a tabla.

El alcance de este comando es el proceso actual. Cada tabla tiene su propio formulario de entrada en cada proceso.

Nota: por razones estructurales, este comando no es compatible con formularios de proyectos. Si pasa un formulario de proyecto en form, el comando no hace nada.

FORM SET INPUT no muestra el formulario; sólo designa cuál formulario se utiliza para la entrada de datos, importación, u operación por otro comando. Para mayor información sobre la creación de formularios, consulte el Manual de Diseño 4D.

El formulario de entrada por defecto para cada tabla se define en la ventana del Explorador. Este formulario de entrada por defecto se utiliza si el comando FORM SET INPUT no se utiliza para especificar un formulario de entrada, o si especifica un formulario que no existe.

El parámetro opcional formUsuario le permite especificar un formulario usuario (proveniente de form) como formulario de entrada por defecto. Si pasa un nombre de formulario usuario correcto, este formulario será utilizado por defecto en lugar del formulario de entrada en el proceso actual. Esto le permite tener simultáneamente diferentes formularios usuarios personalizados (generados utilizando el comando CREATE USER FORM) y utilizar aquel que sea conveniente en función del contexto.

Para mayor información sobre formularios de usuario, consulte la sección Presentación de los formularios de usuario.

Los formularios de entrada son mostrados por numerosos comandos, los cuales generalmente se utilizan para permitir al usuario introducir nuevos datos o modificar datos antiguos. Los siguientes comandos muestran un formulario de entrada para entrada de datos o búsquedas:

Los comandos DISPLAY SELECTION y MODIFY SELECTION muestran una lista de registros utilizando el formulario de salida. El usuario puede hacer doble clic en un registro en la lista y se muestra el formulario de entrada.

Los comandos de importación IMPORT TEXT, IMPORT SYLK e IMPORT DIF utilizan el formulario de entrada actual para importar registros.

El parámetro opcional * se utiliza en conjunto con las propiedades del formulario que definió en la ventana de propiedades del formulario del entorno Diseño y el comando Open window. El especificar el parámetro * le indica a 4D que utilice las propiedades del formulario para redimensionar automáticamente la ventana para el siguiente uso del formulario (como un formulario de entrada o como una caja de diálogo). Ver mayor información en Open window.

Nota: bien sea que pase el parámetro opcional * o no, FORM SET INPUT cambia el formulario de entrada para la tabla.

Ejemplo 1

El siguiente ejemplo muestra un uso típico de FORM SET INPUT:

 FORM SET INPUT([Empresas];"Nueva empresa") ` Formulario para añadir nuevas empresas

 ADD RECORD([Empresas]) ` Añadir una nueva empresa

Ejemplo 2

En una base de facturación que administra varias empresas, la creación de una factura debe efectuarse utilizando el formulario usuario correspondiente:

 Case of

    :(empresa="4D SAS")

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

    :(empresa="4D Inc")

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

    :(empresa="Acme")

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

 End case

 ADD RECORD([Facturas])

Ver también

ADD RECORD
CREATE USER FORM
DISPLAY RECORD
DISPLAY SELECTION
FORM SET OUTPUT
IMPORT DIF
IMPORT SYLK
IMPORT TEXT
MODIFY RECORD
MODIFY SELECTION
Open window
QUERY BY EXAMPLE