$callup
For the trigger that is currently being executed, call that same trigger one level up in the hierarchy. If the trigger is not defined one level up, then the next available level up is called (if applicable).
$callup
Example: return $callup
Return Values
| Value | Meaning |
|---|---|
| NumericValue | The return value from the trigger that was executed one level up. |
Use
This function is only allowed in triggers that can call up to the same trigger at a higher level:
- detail trigger of Field
- help trigger of Field
- menu trigger of Field, Entity, or Component
- receiveMessage trigger of Component
- pulldown trigger of Component
It is not allowed at the most generic level of these triggers, thus not in:
- detail trigger of Entity
- help trigger of Entity
- menu trigger of Application Shell
- receiveMessage trigger of Application Shell
- pulldown trigger of Application Shell
Description
Use the $callup function to call the same trigger at the next level up in the call-up hierarchy , or the next available level up, if applicable.
Upon return from a $callup call, the value of $status is whatever it was at the moment the called-up trigger returned.
Using $callup
The following example shows how the $callup function can be used to call the entity-level detail trigger from a field-level detail trigger:
; The Script container of field FLD.ENT.MDL
trigger detail
variables
string vStatus
endvariables
putmess "This is the field-level detail trigger"
vStatus = $callup
putmess "vStatus is %%(vStatus), $status = %%($status)"
end
;----------------------------------------------------
; The Occurrence Script container of entity ENT.MDL
trigger detail
putmess "This is the entity-level detail trigger"
$status = 321
return 123
end
When the detail trigger of FLD.ENT is activated, the message frame will contain this output:
This is the field-level detail trigger This is the entity-level detail trigger vStatus is 123, $status = 321
| Version | Change |
|---|---|
| 9.7.03.G302, 10.01.01.F102 | Introduced |
