Sidebar
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:
