4D v13.4
FORM SET OUTPUT
- 4D Language Reference
-
- Forms
-
- FORM FIRST PAGE
- FORM Get current pageUpd
- FORM GET HORIZONTAL RESIZING
- FORM GET OBJECTS
- FORM GET PARAMETER
- FORM GET PROPERTIES
- FORM GET VERTICAL RESIZING
- FORM GOTO PAGEUpd
- FORM LAST PAGE
- FORM NEXT PAGE
- FORM PREVIOUS PAGE
- FORM SCREENSHOT
- FORM SET HORIZONTAL RESIZING
- FORM SET INPUT
- FORM SET OUTPUT
- FORM SET SIZE
- FORM SET VERTICAL RESIZING
FORM SET OUTPUT
| FORM SET OUTPUT ( {aTable ;} form {; userForm} ) | ||||||||
| Parameter | Type | Description | ||||||
| aTable | Table |
|
Table for which to set the output form, or Default table, if omitted | |||||
| form | String |
|
Form name | |||||
| userForm | String |
|
Name of user form to use | |||||
The FORM SET OUTPUT command sets the current output form for table to form or userForm. The form must belong to aTable.
The scope of this command is the current process. Each table has its own output form in each process.
Note: For structural reasons, this command is not compatible with project forms. If you pass a project form in form, the command does nothing.
FORM SET OUTPUT 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 4D Design Reference manual.
The default output form is defined in the Explorer window for each table. This default output form is used if the FORM SET OUTPUT command is not used to specify an output form, or if you specify a form that does not exist.
The optional userForm parameter lets you specify a user form (coming from form) as the default output form. If you pass a valid user form name, this form will be used by default instead of the output form in the current process. This allows you to have several different custom user forms simultaneously (generated using the CREATE USER FORM command) and to use the one that suits according to the context.
For more information about user forms, refer to the Get printed height section.
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 FORM SET OUTPUT. Note that although the FORM SET OUTPUT 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:
FORM SET INPUT([Parts];"Parts In") ` Select the input form
FORM SET OUTPUT([Parts];"Parts List") ` Select the output form
MODIFY SELECTION([Parts]) ` This command uses both forms
Product: 4D
Theme: Forms
Number:
54
Modified: 4D 2004
Renamed: 4D v12
CREATE USER FORM
DISPLAY SELECTION
EXPORT DIF
EXPORT SYLK
EXPORT TEXT
FORM SET INPUT
MODIFY SELECTION
PRINT LABEL
PRINT SELECTION
