Default actions in INPUT ARRAY

When an INPUT ARRAY instruction executes, the runtime system creates a set of default actions.

Field validation occurs and different INPUT ARRAY control blocks are executed based on the invoked default action.

This table lists the default actions created for this dialog:

Table 1. Default actions for INPUT ARRAY
Default action Description
accept

Validates the INPUT ARRAY dialog (validates fields and leaves the dialog)

Creation can be avoided with ACCEPT = FALSE attribute.

cancel

Cancels the INPUT ARRAY dialog (no validation, int_flag is set to TRUE)

Creation can be avoided with CANCEL = FALSE attribute.

close

By default, cancels the INPUT ARRAY dialog (no validation, int_flag is set to TRUE)

Default action view is hidden. See Implementing the close action.

insert

Inserts a new row before current row.

Creation can be avoided with INSERT ROW = FALSE attribute.

append

Appends a new row at the end of the list.

Creation can be avoided with APPEND ROW = FALSE attribute.

delete

Deletes the current row.

Creation can be avoided with DELETE ROW = FALSE attribute.

help

Shows the help topic defined by the HELP clause.

Only created when a HELP clause is defined.

nextrow

Moves to the next row in a list displayed in one row of fields.

See note (1).

prevrow

Moves to the previous row in a list displayed in one row of fields.

See note (1).

firstrow

Moves to the first row in a list displayed in one row of fields.

See note (1).

lastrow

Moves to the last row in a list displayed in one row of fields.

See note (1).

find

Opens the fglfind dialog window to let the user enter a search value, and seeks the row matching the value.

See note (2).

findnext

Seeks the next row matching the value entered during the fglfind dialog.

See note (2).

Notes:
  1. The action is only created with a DISPLAY ARRAY or INPUT ARRAY using a screen record bound to a set of form fields in a GRID container, and this set of fields show only a single row of the list. The action is not created when using a screen array bound to a list container such as TABLE, TREE and SCROLLGRID, or to a set of fields in a GRID container, that repeat on several lines to show more than one single row.
  2. The action is only created if the context allows built-in find.
The insert, append, delete, accept and cancel default actions can be avoided with dialog control attributes:
INPUT ARRAY arr TO sr.* ATTRIBUTES( INSERT ROW=FALSE, CANCEL=FALSE, ... )
   ...