OUTPUT FORM

version 3

OUTPUT FORM ({table; }form)

Parameter	Type		Description
table	Table		Table for which to set the output form, or
			Default table, if omitted
form	String		Form name

The command OUTPUT FORM sets the current output form for table to form. The form must belong to table.

The scope of this command is the current process. Each table has its own output form in each process.

OUTPUT FORM does not display the form; it just designates which form is printed, displayed, or used by another command. For information about creating forms, see the 4th Dimension Design Reference.

The default output form is defined in the Design environment Explorer window for each table. This default output form is used if the OUTPUT FORM command is not used to specify an output form, or if you specify a form that does not exist.

Output forms are used by three groups of commands. One group displays a list of records on screen, another group generates reports, and the third group exports data. The DISPLAY SELECTION and MODIFY SELECTION commands display a list of records using an output form. You use the output form when creating reports with the PRINT LABEL and PRINT SELECTION commands. Each of the export commands (EXPORT DIF, EXPORT SYLK and EXPORT TEXT) also uses the output form.

The following example shows a typical use of OUTPUT FORM. Note that although the OUTPUT FORM command appears immediately before the output form is used, this is not required. In fact, the command may be executed in a completely different method, as long as it is executed prior to this method:

   INPUT FORM ([Parts]; "Parts In")  ` Select the input form 
   OUTPUT FORM ([Parts]; "Parts List")  ` Select the output form 
   MODIFY SELECTION ([Parts])  ` This command uses both forms 

DISPLAY SELECTION, EXPORT DIF, EXPORT SYLK, EXPORT TEXT, INPUT FORM, MODIFY SELECTION, PRINT LABEL, PRINT SELECTION.