OnUserDefined

The script attached to this event fires depending on settings made during the OnSpawn event for creatures and some general level blanket signals for all objects (including creatures). Typically this script is a switch/case statement that does something different depending on the signal (numerical value) sent to it by an event that calls the script. This event makes it very easy to retain the default behavior of an object while adding custom mannerisms of your own.

Trigger

A script has used the SignalEvent() function.

Function(s)

GetUserDefinedEventNumber() to return the user defined event number being sent.

Remarks

In a script that generates a user-defined event, use the EventUserDefined(int) function to generate the appropriate internal event identification number which can be consumed in the OnUserDefined script.

Example

// OnUserDefined exists as an event for many objects
// to invoke it for a module, try something like...
// SignalEvent(GetModule(), EventUserDefined(112));
// then say we want to capture user-defined event number 112
// in our module's OnUserDefined event...
void main
{
     switch (GetUserDefinedEventNumber())
     {
          case EventUserDefined(112) :
               PrintString("Event #112 occured!");
               break;
          // ... additional case statements for other user-defined
          // events can be added as neccessary
     }
}

See Also

	Objects with Events | Area | Creature | Door | Encounter | Module | Placeable Object | Trigger
functions:	GetUserDefinedEventNumber

---

 Send comments on this topic.