Function execution on editor fields

The table below displays the functions that are executed and the order of execution for each type of event depending on the Force Exits Execution value defined in the Global UI Settings.

For more information, refer to Specify global UI settings details

Event type Force Exits Execution Behavior
Open editor YES/NO

The CheckValue, ChangeField and GetInitialValues functions attached to editor fields are executed in the order of the fields. The CheckValue functions are executed in silent mode.

Save object YES/NO

The CheckValue, ChangeField and GetInitialValues functions attached to editor fields are executed in the order of the fields. The CheckValue functions are executed in silent mode.

Focus out of a field YES

The CheckValue, ChangeProperty and ChangeField functions attached to the field are executed in this order. If a ChangeProperty function modifies a field value, the CheckValue and ChangeField functions attached to editor fields are executed. The CheckValue functions are executed in silent mode.

Caution   Setting ForceExitsExecution to YES can have a great impact on performance since all functions of the editor would be executed at every focus out event.
Focus out of a field NO

If the field value has not been modified, no function is executed.

If the field value has been modified, the CheckValue, ChangeProperty and ChangeFields functions attached to the field are executed in this order.

If a ChangeProperty function modifies a field value, the CheckValue and ChangeField functions attached to the editor fields are executed. The CheckValue functions are executed in silent mode.

Open combo box YES/NO

The GetContextualValue functions are executed only if at least one field value in the editor was changed since the last execution of the GetContextualValue function.

Note   The first time the combo box is opened, the GetContextualValue functions attached to that field are executed.
Select a value from combo box / Select a date from calendar YES/NO

The CheckValue, ChangeProperty and ChangeField functions attached to the field are executed in this order.

If a ChangeProperty function modifies a field value, the CheckValue and ChangeField functions attached to the editor fields are executed.

The CheckValue functions are executed in silent mode.

When CheckValue functions are executed in silent mode, the fields with errors, if any, are signaled by a red border.

When CheckValue functions are executed in normal mode, the errors, if any, are displayed in a pop-up window and the corresponding fields are signaled by a red border. When errors are raised, the chain is interrupted and all the subsequent ChangeProperty or ChangeField functions are not executed.

If CheckValue functions do not raise errors, but ChangeProperty functions raise errors, the chain is interrupted. The ChangeProperty errors are displayed in a pop-up window and the value modifications are not applied.

If CheckValue functions or ChangeProperty functions raise warnings, the chain is interrupted. If the user presses OK in the warning pop-up window, the chain is restored.

Related Links