3. Statements : OpenROAD Language Statements : On Statement
 
Share this page                  
On Statement
This statement specifies an event block for one or more events.
This statement has the following syntax:
on eventtype [fieldname] | ['eventname'] [(parameterlist)]
          {, on eventtype [fieldname] | ['eventname'] [(parameterlist)} =
[declareblock]
beginendblock[;]
The on statement specifies the start of an event block that is triggered by one or more events.
Although the values of fieldname can be any field or menu item on a frame, do not use the field function with the field or menu item name. If you do not specify a field name and the on statement is in the frame script, the value of fieldname defaults to the frame. If the on statement is in a field or menu item script, the value of fieldname defaults to that field or menu item.
Include a value for eventname only if the event type is userevent, extclassevent, or dbevent. If you do not specify an event name in the event block, OpenROAD executes the block whenever the frame receives any user event or database event, respectively.
For more information about using user events and database events, see the following events:
DBEvent Event (see DBEvent Event)
ExtClassEvent Event (see ExtClassEvent Event)
UserEvent Event (see UserEvent Event)
With user event and external class event activations, you may supply an optional parameter list. The parameter list defines locally, within the given activation, the parameters that will be set when this activation occurs. The parameters are set to the values prescribed when the event was originally sent.