User Tools

Site Tools


VALUE CHANGED

Guide Section: Processing Events and Performing Actions | EASAP Tree: EVENT PROCESSING > EVENT


When one of several visible data entry objects change, VALUE CHANGED creates a reference to the changed object and then triggers an EVENT.

One or more objects are listed in Objects: and if one of them changes: the Event Source: references the object that has changed and an subsequent EVENT is triggered with corresponding ACTIONs.

If no objects are specified, VALUE CHANGED will behave globally: if any value in the EASAP changes, the ACTIONs associated with the VALUE CHANGED EVENT will take place.

Value Changed
Optional Parameters:
Objects:Select one or more visible data entry objects. If left empty, it will be triggered by the change of any value in the EASAP
Warning: if a FILE CHOICE is used here, a subsequent WRITE EXCEL ACTION will introduce a 'race condition' between the two and should be avoided
Event Source:Enter a name of a new SCALAR that will identify by name which object in Objects: has changed.

An Example

To trigger SET STYLE ACTION from a VALUE CHANGED EVENT:

  • Right-click: USER INTERFACE
  • Select: Child > Add USER INTERFACE STYLE LIST
  • Right-click: USER INTERFACE STYLE LIST
  • Select: Child > Add USER INTERFACE STYLES
  • Right-click: USER INTERFACE STYLES
  • Select: Child > Add USER INTERFACE STYLE
  • Right-click: user_interface_style1
  • Select: Child > Add BACKGROUND
  • Set Color: blue
  • Right-click: BACKGROUND
  • Select: Sibling > Add TEXT STYL
  • Set Color: red

Create two or more data entry objects: input1, input2, …

  • Add an EVENT PROCESSING
  • Right-click: EVENT branch
  • Select: Child > Add VALUE CHANGED
  • Set Objects: input1,input2,…
  • Set Event Source: changedBox
  • Right-click: ACTION branch
  • Select: Child > Add SET STYLE ACTION
  • Set Object: changedBox

changedBox's value is the particular input that changed.

The name changedBox is declared in Event Source: above.

So now in our example: if input2 changes, only its USER INTERFACE STYLE will be updated: in this case red text on a blue background.

Screenshots showing the VALUE CHANGED and SET STYLE ACTION configuration below: