Grass Valley Xpanel Vertigo Suite v.4.8 - Manual (Page 90)

5-4 Xpanel User Manual
Adding events and actions to primitives and objects
Adding a user event
User events are used when you have a requirement that cannot be met by any of the
standard events. Since they cannot be triggered by the system, they are usually triggered
by calling a S
END E VENT action in response to another event.
A common use for a user event is triggering actions required by more than one object. For
example, if you had several buttons on a panel that used a common set of actions, you
could create a User event on one of the objects to contain the common actions. Next, you
would use the S
END E VENT action for every object requiring these actions in order to send
the User event to the object with the common actions. The result is akin to a function call or
a subroutine, and it reduces the margin of error when modifications to the common action
set are required, since changes only need to be made once.
To create a user event:
1.
Select the panel or the object for which you would like the event available.
If the event is for the panel itself, click anywhere where there are no objects.
2. In the Action Editor, click the A DD U SER E VENT button.
The A DD NEW USER EVENT window appears.
3. Enter a name for your event in the field provided.
4. Click OK.
You can now add actions to the event as required (see
page 5-12 ).
Example: Parametrized User events
User events can include parameters to supply more information to be used within the action.
Since parametrized User events are only likely to be used in very specific cases, what
follows is a generic example of a control panel that allows the operator to set the text of one
text box, and at the click of the button the text changes slightly and also appears in another
text box.
To create a panel using parametrized User events:
1.
Create a new control panel with three (3) text boxes and a button.
2. Select T EXTBOX 2 and then display the A CTION E DITOR (CTRL + E).
You will create a new event for Textbox2.
3. Click the A DD U SER E VENT button.