CONSTRUCT instruction configuration

This section describes the options that can be specified in the ATTRIBUTES clause of the CONSTRUCT instruction. The options of the ATTRIBUTES clause override all default attributes and temporarily override any display attributes that the OPTIONS or the OPEN WINDOW statement specified for these fields. With the CONSTRUCT statement, the INVISIBLE attribute is ignored.

NAME option

The NAME attribute can be used to name the CONSTRUCT dialog. This is especially used to identify actions of the dialog.

The clause specifies the number of a message to display if the user invokes the help dialog. The predefined 'help' action is automatically created by the runtime system. You can bind to the 'help' action.

HELP option

HELPhelp messageCONSTRUCTaction views

The HELP clause overrides the HELP attribute.

FIELD ORDER FORM option

By default, the tabbing order is defined by the variable binding list in the instruction description. You can control the tabbing order by using the FIELD ORDER FORM attribute. When this attribute is used, the tabbing order is defined by the TABINDEX attribute of the form fields. If this attribute is used, the Dialog.fieldOrder FGLPROFILE entry is ignored.

The OPTIONS instruction can also change the behavior of the INPUT instruction, with the INPUT WRAP or FIELD ORDER FORM options.

ACCEPT option

The ACCEPT attribute can be set to FALSE to avoid the automatic creation of the accept default action. This option can be used for example when you want to write a specific validation procedure, by using ACCEPT INPUT.

CANCEL option

The CANCEL attribute can be set to FALSE to avoid the automatic creation of the cancel default action. This is useful for example when you only need a validation action (accept), or when you want to write a specific cancellation procedure, by using EXIT INPUT.

If the CANCEL=FALSE option is set, no close action will be created, and you must write an ON ACTION close control block to create an explicit action.