<event>

The <event> tag declares that the containing object can generate the event named name. Note that the name of the event must not begin witn an underscore.

1. In a class definition, the <event> tag defines an event that can be sent from instances of the class.

     <class name="myclass_with_handler">
       <event name="myevent"/>
       <handler name="myevent" args="myargs">
          Debug.write(this, 'handling myevent, myargs=', myargs);
       </handler>
     </class>
   

2. In LZX, events are generated automatically by the setAttribute method. When you call obj.setAttribute('attrname', val), an event named with the prefix "on" and name of an the attribute is sent, in this case the event called would be named onattrname and a single arg value of val would be passed.

     <class name="myclass_with_handler">
       <event name="myevent"/>
       <attribute name="blah" value="259"/>
       <event name="onblah"/>
       <handler name="onblah" args="val">
         Debug.write(this, 'handler for onblah', val);
       </handler>
     </class>
   

See the Guide for a complete discussion.

Also see the documentation for <handler>.