You are here:

Control attributes

The control attributes are usually required when you need to define the behavior of the application while executing the statement to which these attributes are assigned. Some of them—for example, STYLE or IMAGE—may also define the presentation of information displayed.

Pay extra attention to the attributes supported by INPUT, INPUT ARRAY, CONSTRUCT and DISPLAY ARRAY sub-interactions, as they differ from the attributes that can be assigned to the same but standalone statements. The list of them for the DIALOG clauses is reduced, since some functions are transferred to the DIALOG statement.

ACCEPT and CANCEL

The ACCEPT and CANCEL attributes are used to indicate whether the default Accept or Cancel action should be added to the dialog window.

Syntax:

ATTRIBUTE(<attr_name> = <value>, <attr_name> = <value>)

<attr_name>: {ACCEPT, CANCEL}

<value>: {true, false, 1, 0, <var>}

Examples:

ATTRIBUTE(ACCEPT = TRUE, CANCEL = TRUE)

ATTRIBUTE(ACCEPT = 1, CANCEL = 1)

ATTRIBUTE(ACCEPT = FALSE, CANCEL = FALSE)

ATTRIBUTE(ACCEPT = var1, CANCEL = var2)

INPUT f1,f2,f3 FROM field1,field2,field3 ATTRIBUTE(CANCEL = FALSE)

Note: Omitting this attribute, as well as the TRUE (1) value assigned to it, results in actions being added to the program. The FALSE value will result in action being not registered.

This attribute can only be used for DIALOG, INPUT, and INPUT ARRAY

HELP

The HELP attribute is specified within the attribute clause to define the help message associated with the statement that is a literal integer or a program variable. For example:

ATTRIBUTE (HELP = 78): the help keystroke will result in displaying the help message number 78;
ATTRIBUTE (HELP = var): the help keystroke will result in displaying the help message number assigned to the program variable var.

NAME

The NAME attribute is used to set the unique name to the statement within which it is assigned to make easier the further manipulations with it.