DISPLAY ARRAY ATTRIBUTES clause

Attributes of the DISPLAY ARRAY clause of a DIALOG block.

HELP option

The HELP attribute defines the number of the help message to be displayed when invoked and focus is in the list controlled by the DISPLAY ARRAY sub-dialog. The predefined 'help' action is automatically created by the runtime system. You can bind action views to the 'help' action.

The HELP clause overrides the HELP attribute.

COUNT option

The COUNT attribute defines the number of valid rows in the static array to be displayed as default rows. If you do not use the COUNT attribute, the runtime system cannot determine how much data to display, so the screen array remains empty. The COUNT option is ignored when using a dynamic array, unless page mode is used. In this case, the COUNT attribute must be used to define the total number of rows, because the dynamic array will only hold a page of the entire row set. If the value of COUNT is negative or zero, it defines an empty list.

See also Controlling the number of rows.

DOUBLECLICK option

The DOUBLECLICK option can be used to define the action that will be fired when the user chooses a row from the list. Different configuration options are available to control the row selection action of desktop and mobile devices. For more details, see Defining the action for a row choice.

ACCESSORYTYPE option

Important: This feature is only for mobile platforms.

The ACCESSORYTYPE attribute can be used to define the decoration of rows, typically used on an iOS device. Values can be DETAILBUTTON, DISCLOSUREINDICATOR, CHECKMARK to respectively get a (i), > or check mark icon. For more details, see Row configuration on iOS devices.

DETAILACTION option

Important: This feature is only for mobile platforms.

The DETAILACTION attribute can be used to define the action that will be fired when the user selects the detail button of a row. The detail button is typically shown with a (i) icon on iOS devices. Note that the DOUBLECLICK attribute can be used to distinguish the action when the user selects the row instead of the detail button in the row. For more details, see Row configuration on iOS devices.

FOCUSONFIELD option

Important: This feature is not supported on mobile platforms.

When the FOCUSONFIELD option is used, the DISPLAY ARRAY allows focus at the field (or cell) level. It it then possible to implement BEFORE FIELD and AFTER FIELD blocks, as well as using NEXT FIELD instructions. However, the dialog still manages a read-only list. For more details, see Field-level focus in DISPLAY ARRAY.