The DIALOG control class

This topic explains the purpose of the ui.DIALOG class.

Inside a dialog instruction, the DIALOG predefined keyword represents the current dialog object. This dialog object can be used to execute methods provided by the ui.DIALOG built-in class.

For example, you can enable or disable an action with the setActionActive() dialog method, or you can hide or show the default action view with the setActionHidden() method:

BEFORE INPUT
  CALL DIALOG.setActionActive("zoom",FALSE)
AFTER FIELD field1
  CALL DIALOG.setActionHidden("zoom",TRUE)

The setFieldActive() method can be used to enable or disable a field during the dialog:

ON CHANGE custname
   CALL DIALOG.setFieldActive( "custaddr",
               (rec.custname IS NOT NULL) )

The ui.Dialog class also provides methods to configure the dialog, for example to enable multiple row selection:

BEFORE DIALOG
   CALL DIALOG.setSelectionMode( "sr1", 1 )