Default actions in DISPLAY ARRAY

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

Field validation occurs and different DISPLAY 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 created for the DISPLAY ARRAY dialog
Default action Description
accept

Validates the DISPLAY ARRAY dialog (validates current row selection)

Creation can be avoided with ACCEPT = FALSE attribute.

cancel

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

Creation can be avoided with CANCEL = FALSE attribute.

close

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

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

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 searches for the row matching the value.

See note (2).

findnext

Searches for 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 accept and cancel default actions can be avoided with the ACCEPT and CANCEL dialog control attributes:
DISPLAY ARRAY arr TO sr.* ATTRIBUTES( CANCEL=FALSE, ... )
  ...