Using Event Listeners - MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT Reference Manual

Using event listeners

Event listeners let an object, called a listener object, receive events generated by another object,
called a broadcaster object. The broadcaster object registers the listener object to receive events
generated by the broadcaster. For example, you could register a movie clip object to receive
notifications from the Stage, or a button instance could receive
onResize
notifications from a text field object. You can register multiple listener objects to receive events
from a single broadcaster, and you can register a single listener object to receive events from
multiple broadcasters.
The event model for event listeners is similar to that of event handlers (see
methods" on page
•
The object to which you assign the event handler is not the object that emits the event.
•
You call a special method of the broadcaster object,
listener object to receive its events.
To use event listeners, you create a listener object with a property that has the name of the event
being generated by the broadcaster object. You then assign a function to the event listener that
responds in some way to the event. Lastly, you call
broadcasting the event, passing it the name of the listener object. The following code outlines the
event listener model.
listenerObject.eventName = function(){
// your code here
};
broadcastObject.addListener(listenerObject);
The specified listener object can be any object, such as a movie clip or button instance on the
Stage, or an instance of any ActionScript class. The event name is an event that occurs on
broadCastObject
multiple listeners to one event broadcaster.
The following example shows how to use the
simple focus manager for a group of input text fields. In this case, the border of the text field that
receives keyboard focus is enabled (displayed), and the border of the text field that lost focus
is disabled.
83), with two main differences:
, which then broadcasts the event to
addListener()
addListener()
listenerObject
Selection.onSetFocus
onChanged
"Using event handler
, which registers the
on the object that's
. You can register
event listener to create a
Using event listeners 85