<handler>

Attaches a handler method for the named event to the object that contains this element. The handler method must have a name

The name attribute gives the event for which this handler should be invoked.

Events can be declared via the <event> tag. Events are also generated whenever the value of an attribute is changed using the setAttribute method.

For example, if a handler is defined via:

<view id="obj">
  <handler name="onmyevent" args="a">
    this.setBGColor(0xff0000);
    Debug.write(this,'got onblah event, arg is',a);
  </handler>
</view>

then script code obj.onmyevent.sendEvent(259) will invoke this handler method.

The argument passed to an event handler is whatever value was used in the call to sendEvent() which generated the event. In the case where an attribute value is set using setAttribute, the new value is sent as the argument to sendEvent, and that will be the argument value received to any user-defined handler for that event.