ui.Dialog.getFieldTouched

Returns the modification flag for a field.

Syntax

getFieldTouched(
   field-list STRING )
  RETURNING result BOOLEAN

field-list is the string with the list of field specification.

Usage

The getFieldTouched() method returns TRUE if the modification flag of the specified field(s) is set.

The field-list is a string containing the field qualifier, with an optional prefix ("[table.]column"), a table prefix followed by a dot and an asterisk ("table.*"), or a simple asterisk ("*").

This code checks if a specific field has been touched:

AFTER FIELD cust_name 
  IF DIALOG.getFieldTouched("customer.cust_address") THEN
     ...

If the parameter is a screen record following by dot-asterisk, the method checks the touched flags of all the fields that belong to the screen record:

ON ACTION quit 
  IF DIALOG.getFieldTouched("customer.*") THEN
    ...

When passing a simple asterisk (*) to the method, the runtime system will check all fields used by the dialog:

ON ACTION quit 
  IF DIALOG.getFieldTouched("*") THEN
    ...

For more details about field name specification, see Identifying fields in dialog methods.