ui.Dialog.createInputByName

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

Syntax

ui.Dialog.createInputByName(
   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 a RECORD structure, with a name and type member of type STRING.
  2. The method returns a new ui.Dialog object.

Usage

The ui.Dialog.createInputByName() class method creates a dialog object to implement the equivalent of a static INPUT BY NAME 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.

A dynamic input dialog behaves like a static INPUT dialog using the WITHOUT DEFAULTS option: The DEFAULT attribute of the form-field is not used.

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.createInputByName(fields)
...