INPUT ARRAY clause

INPUT ARRAY clause is similar in syntax and behavior to the standalone INPUT ARRAY statement, though there are some differences.

Program Array	The name of a variable of the static or dynamic ARRAY of RECORD data type
Screen Array	The name of a screen array declared in the form file
ATTRIBUTE Clause	The list of attributes of the INPUT ARRAY clause. It is a reduced version of the attributes of the standalone INPUT ARRAY statement
Control Clause	INPUT ARRAY control clauses

The INPUT ARRAY clause does not have the WITHOUT DEFAULTS keywords or the HELP clause and has a reduced ATTRIBUTE clause.

ATTRIBUTE clause

ATTRIBUTE clause differs much from the ATTRIBUTE clause if the standalone INPUT ARRAY statement. The ATTRIBUTE clause has the following syntax:

BOOL Expression	A 4GL expression that returns either 1 (meaning TRUE) or 0 (meaning FALSE) or literal 1 or 0
Integer Expression	A 4GL expression that returns an integer value or a literal integer value

This ATTRIBUTE clause does not include any color or intensity attributes, since it is advised that you use the themes to adjust the appearance of your 4GL programs rather than use 4GL attributes.

The ATTRIBUTE block of the INPUT ARRAY clause is a reduced version of the ATTRIBUTE clause of the INPUT ARRAY statement. The reduced clause does not include the color and intensity attributes. It also forbids the ACCEPT, CANCEL, FIELD ORDER FORM and UNBUFFERED control attributes usage, since these functions are transferred to the DIALOG statement.

It has these attributes:

COUNT - defines the number of rows in a program array
MAXCOUNT - Defines the maximum number of data rows that can be entered into the program array
HELP - specifies the help article index to be used when the cursor is in the INPUT ARRAY fields
WITHOUT DEFAULTS - if present or if present and set to 1 the fields display the values of the underlying variables rather than the default field values
DELETE ROW - if present or if present and set to 1 allows the user to delete program array rows with the delete key
INSERT ROW- if present or if present and set to 1 allows the user to insert program array rows with the insert key
APPEND ROW - if present or if present and set to 1 allows the user to append program array rows at the end of the program array
AUTO APPEND - if present or if present and set to 1 specifies that temporary rows will be created at the end of the program array, when needed
KEEP CURRENT ROW - if present or if present and set to 1 allows specifies that the current row will remain highlighted after the execution of the given instruction

INPUT ARRAY control clause

These control clauses have almost the same syntax and behavior as the control blocks of the standalone INPUT ARRAY statement with a single exception. The ON IDLE control block cannot be used in the INPUT ARRAY clause of the DIALOG statement, since its role is taken over by the ON IDLE block of the DIALOG statement itself.

END INPUT keywords

END INPUT keywords are obligatory for every INPUT ARRAY clause of the DIALOG statement, even if the INPUT ARRAY clause does not contain any control blocks.