The prefix specified for the field name must match the one that is given to the field at the beginning of an interactive statement when the ui.Dialog object is bound to the necessary dialog block.
These ui.Dialog methods are used for manipulating fields during multiple input or display.
They require field reference as an argument. You can refer to the necessary field/fields following these syntax options:
field_name
table_name.field_name
screen_record_name.field_name
FORMONLY.field_name
If the prefix is omitted, the method is applied to the first field in the form that matches the provided argument.
If the specified field cannot be found, a runtime error, -1373, will occur.
The prefix specified for the field name must match the one that is given to the field at the beginning of an interactive statement when the ui.Dialog object is bound to the necessary dialog block.
If the screen record was specified implicitly (e.g., in an INPUT BY NAME statement), the field prefix must be
the name of any valid screen-record in which the field is engaged, or
the FORMONLY keyword, or
a database table name used in the form file.
If a screen record is specified explicitly in the dialog FROM clause (e.g., as INPUT .. FROM screen_record.*), the prefix must match the name of the screen record given in the FROM clause.
Some methods - e.g., validate(), setFieldTouched(), getFieldTouched(), setFieldActive() - can take several fields as an argument ("customer_rec.*").
|
enables/disables form fields used in the current dialog (disabled fields remain visible but cannot be edited) |
|
|
returns the input buffer of the specified field |
|
|
marks the specified field as touched (i.e. says that its value has changed during the input) |
|
|
inserts a row to the given position of the list |
|
|
appends a row to the end of the current list |
|
|
deletes a row from the specified screen array list |
|
|
removes all the rows from the DISPLAY ARRAY or INPUT ARRAY list |
|
|
inserts a row to the given position of the list (is applied to dialogs working with a tree table) |
|
|
add a new node within a specified parent (is applied to dialogs working with a tree table) |
|
|
delete the specified node together with all its child nodes (is applied to dialogs working with a tree table) |
|
|
checks the values input to the form fields according to the parameters specified in INCLUDE, NOT NULL and REQUIRED field attributes |
|
|
changes the value of the UNBUFFERED attribute |
|
|
enables or disables multi-row selection |
|
|
specifies what range of rows is selected in a multi-row selection mode |
|
|
passes the values of the selected rows to a tab-separated list (in a single-row selection mode, returns the currently selected row) |
|
|
check whether the row is selected in a multi-row selection mode |
|
|
sets display attributes for the specified cells of the screen array (REVERSE, UNDERLINE, BLINK, colors) |
|
|
specifies display attributes for singular dialogs within one screen array |