FORM LOAD

4D v16.3

FORM LOAD


FORM LOAD ( {aTabla ;} formulario {; *} )

Parámetro	Tipo	Descripción
aTabla	Tabla	Tabla del formulario a cargar (si se omite, carga un formulario proyecto)
formulario	Cadena	Nombre del formulario proyecto a abrir para la impresión o Cadena vacía para cerrar el formulario proyecto actual
*	Operador	Si se pasa = el comando se aplica a la base local cuando se ejecuta desde un componente (parámetro ignorado fuera de este contexto)

Descripción

El comando FORM LOAD se utiliza para cargar el formulario (proyecto o tabla) en memoria con el fin de imprimir sus datos o analizar sus contenidos. Sólo puede haber un formulario actual por proceso.

Para que este comando pueda ejecutarse, una tarea de impresión debe haberse abierto de antemano usando el comando OPEN PRINTING JOB. El comando OPEN PRINTING JOB hace un llamado implícito al comando FORM UNLOAD, por lo que en este contexto es necesario ejecutar FORM LOAD. Una vez cargado, el formulario se convierte en el formulario de impresión actual. Todos los comandos de gestión de objetos, y en particular, el comando Print object, trabajan con este formulario.

Si un formulario de impresión ya se ha cargado previamente (a través de una llamada anterior al comando FORM LOAD), se cierra y se sustituye por formulario. Puede abrir y cerrar varios formularios proyecto en la misma sesión de impresión. Cambiar de formulario de impresión vía el comando FORM LOAD no genera saltos de página. Es responsabilidad del desarrollador gestionar los saltos de página.

Sólo el evento formulario On Load se ejecuta durante la apertura del formulario, así como los métodos de los objetos del formulario. Se ignoran los otros eventos formulario. El evento de formulario On Unload se ejecuta al final de la impresión.

Para mantener la coherencia gráfica de los formularios, se recomienda aplicar la propiedad de apariencia "Impresión ", independientemente de la plataforma.

El formulario de impresión actual se cierra automáticamente cuando se llama el comando CLOSE PRINTING JOB.

Nota de compatibilidad: en las versiones de 4D anteriores a la v14, el comando FORM LOAD (llamado OPEN PRINTING FORM ) aceptaba una cadena vacía en el parámetro formulario para cerrar el formulario de proyecto actual. Esta sintaxis ya no se admite y devuelve un error. Debe utilizar el comando FORM UNLOAD o el comando CLOSE PRINTING JOB para cerrar el formulario.

Análisis del contenido del formulario

Esta posibilidad consiste en cargar un formulario fuera de pantalla para análisis. Para efectuar esta acción, basta con llamar a FORM LOAD fuera del contexto de un trabajo de impresión. En este caso, los eventos de formulario no se ejecutan.

FORM LOAD] se puede utilizar con los comandos FORM GET OBJECTS y OBJECT Get type para llevar a cabo cualquier tipo de procesamiento en el contenido del formulario. A continuación, es imperativo llamar al comando FORM UNLOAD para descargar el formulario de la memoria.

Tenga en cuenta que en todos los casos, el formulario en la pantalla permanece cargado (no se ve afectado por el comando FORM LOAD por lo que no es necesario volver a cargarlo después de llamar a FORM UNLOAD.

Cuando el comando se ejecuta desde un componente, carga los formularios componente por defecto. Si pasa el parámetro *, el método carga los formularios de la base local.

Recordatorio: en el contexto fuera de pantalla, no olvide llamar FORM UNLOAD para evitar todo riesgo de saturación de la memoria.

Ejemplo 1

Llamar un formulario proyecto en un trabajo de impresión:

 OPEN PRINTING JOB

 FORM LOAD("print_form")

  // ejecución de eventos y métodos objeto

Ejemplo 2

Llamar un formulario tabla en un trabajo de impresión:

 OPEN PRINTING JOB

 FORM LOAD([People];"print_form")

  // ejecución de eventos y métodos de objeto

Ejemplo 3

Análisis del contenido de un formulario para efectuar un procesamiento en las áreas de entrada de texto:

 FORM LOAD([People];"my_form")

  // selección del formulario sin ejecución de los eventos ni de los métodos

 FORM GET OBJECTS(arrObjNames;arrObjPtrs;arrPages;*)

 For($i;1;Size of array(arrObjNames))

    If(OBJECT Get type(*;arrObjNames{$i})=Object type text input)

  //… procesamiento

    End if

 End for

 FORM UNLOAD //no olvidar descargar el formulario

Ver también

Current form name
FORM UNLOAD
LISTBOX GET OBJECTS
OBJECT Get type
Print object

4D v16.3

FORM LOAD

FORM LOAD

Descripción

Impresión de datos

Análisis del contenido del formulario

Ejemplo 1

Ejemplo 2

Ejemplo 3