Field Clause

The field clause specifies one or more screen fields or screen records.

4GLREF00000224.gif

field is a field name, as declared in the ATTRIBUTES section of the form specification file.

line is an integer expression, enclosed within brackets, to specify a record within the screen array. Here 1 <= line <= size, for size the array size that is declared in the INSTRUCTIONS section. If you omit the [line] specification, the default is the first record.

screen array is the 4GL identifier that you declared for a screen array in the INSTRUCTIONS section of the form specification file.

screen record is the 4GL identifier that you declared for a screen record, or else a table reference (as the name of a default screen record).

table reference is the name, alias, or synonym of a database table or view.

A table reference cannot include table qualifiers. You must declare an alias in the form specification file, for any table reference that requires a qualifying prefix (such as database, server, or owner). Here the FORMONLY keyword acts like a table reference for fields that are not associated with a database column.

You can use the asterisk ( * ) symbol to specify every field in a screen record.

Some contexts, such as the NEXT FIELD clause, support only a single-field subset of this syntax. In these contexts, the THRU or THROUGH keyword, asterisk notation, and comma-separated list of field names are not valid.

You can specify one or more of the following in the field clause:

A field name without qualifiers (field) if this name is unique in the form

A field name, qualified by a table reference (FORMONLY field or table field)

An individual member of a screen record (record field)

An individual field within a screen array (array [line].field)

A set of consecutive fields in a screen record (by the THRU notation)

An entire screen record (record.*)

The first screen record in a screen array (array.* )

Any entire record within a screen array (array [line].*)

References

CLEAR

CONSTRUCT

DISPLAY

INPUT

INPUT ARRAY

SCROLL

THRU