ROWBOUND action attribute

The ROWBOUND attribute defines if the action is related to the row context of a record list.

Syntax

(only in action handlers of record list dialog)

ROWBOUND

Usage

The ROWBOUND attribute is to be used in a DISPLAY ARRAY or INPUT ARRAY dialog action handler, when the action depends on the row context. Actions marked with this attribute will be automatically enabled/disabled, based on current row existence, and will be rendered in a way depending on the front-end platform.

Important: This feature is only for mobile platforms.
Note: The main purpose of the ROWBOUND attribute is to have the corresponding action enabled and disabled automatically by the runtime system, depending on the existence of a row. The default decoration of such action is front-end platform driven and is the consequence of using the ROWBOUND action attribute. A DISPLAY ARRAY or INPUT ARRAY can be used with a plain form that show a single row at a time. The rowbound actions can also be used in such case, using form buttons as action views for example. These buttons will be automatically enabled/disabled according to the list content.

If a default action view is displayed for the action, it is automatically hidden when no current row context is available. The defaut action view can however be forced with DEFAULTVIEW=YES.

The ROWBOUND attribute can only be specified in a list handling dialog (INPUT ARRAY or DISPLAY ARRAY), as action attribute in the ATTRIBUTES() clause of ON ACTION handlers, and applies to the actions defined by the current dialog in the current window.

Automatic update and delete actions of INPUT ARRAY, as well as actions created by ON UPDATE and ON DELETE modification trigger in DISPLAY ARRAY, are implicitly rowbound actions. Such actions must be available only when at least one row exists in the list. Therefore, the ROWBOUND attribute cannot be specified in DISPLAY ARRAY modification triggers.

Example

DISPLAY ARRAY ...
   ...
   ON ACTION print ATTRIBUTES(ROWBOUND)
      CALL print_customer_info(arr_curr())
   ...