ui.Dialog methods

Methods of the ui.Dialog class.

Table 1. Class methods
Name Description
ui.Dialog.createConstructByName(
   fields DYNAMIC ARRAY OF RECORD
                        name STRING,
                        type STRING
                    END RECORD
   )
Creates a new ui.Dialog object to handle a CONSTRUCT BY NAME.
ui.Dialog.createDisplayArrayTo(
   fields DYNAMIC ARRAY OF RECORD
                        name STRING,
                        type STRING
                    END RECORD,
   tabname STRING )
Creates a new ui.Dialog object to handle a DISPLAY ARRAY.
ui.Dialog.createInputByName(
   fields DYNAMIC ARRAY OF RECORD
                        name STRING,
                        type STRING
                    END RECORD
   )
Creates a new ui.Dialog object to handle an INPUT BY NAME.
ui.Dialog.getCurrent()
  RETURNING result ui.Dialog
Returns the current dialog object.
ui.Dialog.setDefaultUnbuffered(
   value BOOLEAN )
Set the default unbuffered mode for all dialogs.
Table 2. Object methods
Name Description
accept()
Validates and terminates the dialog.
addTrigger(
   name STRING )
Adds an event trigger to the dynamic dialog
appendNode(
   name STRING,
   index INTEGER )
Appends a new node in the specified tree-view.
appendRow(
   name STRING )
Appends a new row in the specified list.
deleteAllRows(
   name STRING )
Deletes all rows from the specified list.
arrayToVisualIndex(
   name STRING,
   index INTEGER )
Converts the program array index to the visual index for a given screen array.
deleteNode(
   name STRING,
   index INTEGER )
Deletes a node from the specified tree-view.
deleteRow(
   name STRING,
   index INTEGER )
Deletes a row from the specified list.
getArrayLength(
   name STRING )
  RETURNING result INTEGER
Returns the total number of rows in the specified list.
getCurrentItem()
  RETURNING result STRING
Returns the current item having focus.
getCurrentRow(
   name STRING )
  RETURNING result INTEGER
Returns the current row of the specified list.
getFieldBuffer(
   field STRING )
  RETURNING result STRING
Returns the input buffer of the specified field.
getFieldTouched(
   field-list STRING )
  RETURNING result BOOLEAN
Returns the modification flag for a field.
getFieldValue(
   name STRING )
Returns the value of a field controlled by a dynamic dialog.
getForm()
  RETURNING result ui.Form
Returns the current form used by the dialog.
getSortKey(
   screen-array STRING )
  RETURNING field-name STRING
Returns the name of the sort field selected by the user.
insertNode(
   name STRING,
   index INTEGER )
Inserts a new node in the specified tree.
insertRow(
   name STRING,
   index INTEGER )
Inserts a new row in the specified list.
isRowSelected(
   name STRING,
   index INTEGER )
  RETURNING result BOOLEAN
Queries row selection for a give list and row.
isSortReverse(
   screen-array STRING )
  RETURNING result BOOLEAN
Indicates the sort order direction (FALSE=ascending, TRUE=descending)
nextField(
   name STRING )
Registering the next field to jump to.
nextEvent()
   RETURNING event STRING
Waits for a dialog event.
selectionToString(
   name STRING )
  RETURNING result STRING
Serializes data of the selected rows.
setActionActive(
  name STRING,
  active BOOLEAN )
Enabling and disabling dialog actions.
setActionHidden(
   name STRING,
   hide BOOLEAN )
Showing or hiding a default action view.
setArrayAttributes(
   name STRING,
   attributes ARRAY )
Define cell decoration attributes array for the specified list (singular or multiple dialogs).
setArrayLength(
   name STRING,
   len INTEGER )
Sets the total number of rows in the specified list.
setCellAttributes(
   attributes ARRAY )
Define cell decoration attributes array for the specified list (singular dialog only).
setCompleterItems(
   items-array DYNAMIC ARRAY OF STRING )
Define autocompletion items for the a field defined with COMPLETER attribute.
setCurrentRow(
   name STRING,
   row INTEGER )
Sets the current row in the specified list.
setFieldActive(
   field-list STRING,
   active BOOLEAN )
Enable and disable form fields.
setFieldTouched(
   field-list STRING,
   touched BOOLEAN )
Sets the modification flag of the specified field.
setFieldValue(
   name STRING,
   value fgl-type )
Sets the value of a field controlled by the dialog object.
setSelectionMode(
   name STRING,
   mode INTEGER )
Defines the row selection mode for the specified list.
setSelectionRange(
   name STRING,
   start INTEGER,
   end INTEGER,
   value BOOLEAN )
Sets the row selection flags for a range of rows.
validate(
   field-list STRING )
  RETURNING result INTEGER
Check form level validation rules.
visualToArrayIndex(
   name STRING,
   index INTEGER )
Converts the visual index to the program array index for a given screen array.