ui.Dialog.createConstructByName

Creates an ui.Dialog object to implement a dynamic CONSTRUCT BY NAME.

Syntax

ui.Dialog.createConstructByName(
   fields DYNAMIC ARRAY OF RECORD
                        name STRING,
                        type STRING
                    END RECORD
   )
  RETURNS ui.Dialog
  1. fields is the list of form fields controlled by the dialog. This must be a DYNAMIC ARRAY of RECORD structure, with a name and type member of type STRING.
  2. The method returns a new ui.Dialog object.

Usage

The ui.Dialog.createConstructByName() class method creates a new dialog object to implement the equivalent of a static CONSTRUCT block.

The current form will be attached to the created dialog.

The method takes a list of field definitions as parameter, as described in Field definition for Dynamic Dialogs.

Important:

Static CONSTRUCT dialog instructions use the data types of the fields defined in the .per form specification file. Unlike static CONSTRUCT, the dynamic construct uses the data type provided in the dynamic array defining the list of fields.

A dynamic dialog can be configured with the setDialogAttribute() method.

Example

DEFINE fields DYNAMIC ARRAY OF RECORD
                        name STRING,
                        type STRING
              END RECORD
DEFINE d ui.Dialog
...
LET d = ui.Dialog.createConstructByName(fields)
...