ui.Dialog.setFieldActive

Enable and disable form fields.

Syntax

setFieldActive(
   fields STRING,
   val BOOLEAN )
  1. fields is the string with the list of field specification, see Identifying fields in ui.Dialog methods.
  2. val is a boolean value.

Usage

The setFieldActive() method can be used to enable / disable form fields.

The fields is a string containing the field qualifier, with an optional prefix ("[table.]column"), or a table prefix followed by a dot and an asterisk ("table.*").

CALL DIALOG.setFieldActive( "customer.cust_addr",
            (rec.cust_name IS NOT NULL) )

Do not disable or hide all fields of a dialog, otherwise the dialog execution stops: At least one field must be able to get the focus during a dialog execution.

Do not disable/hide the current field having the focus. When disabling or when hiding the current field, the AFTER FIELD block of the current field and the BEFORE FIELD block on the next field in the tabbing order will be executed. In a multiple dialog, if the next field in the tabbing order is in another sub-dialog, the AFTER INPUT block of the current sub-dialog and the BEFORE INPUT/CONSTRUCT/DISPLAY or the next sub-dialog are executed. In all these control blocks, a NEXT FIELD to the field that is disabled or hidden will result in an endless loop.