User Guide

562 Chapter 6: Components Dictionary
}
myMenu.addEventListener("menuHide", form);
See also
Menu.menuShow
Menu.menuShow
Availability
Flash Player 6 (6.0 79.0).
Edition
Flash MX Professional 2004.
Usage
listenerObject = new Object();
listenerObject.menuShow = function(eventObject){
// insert your code here
}
myMenu.addEventListener("menuShow", listenerObject)
Description
Event; broadcast to all registered listeners whenever a menu opens. All parent nodes open menus
to show their children.
Version 2 components use a dispatcher-listener event model. When a Menu component
dispatches a
menuShow event, the event is handled by a function (also called a handler) that is
attached to a listener object (
listenerObject) that you create. You call the
addEventListener() method and pass it the name of the handler and listener object as
parameters.
When the event is triggered, it automatically passes an event object (
eventObject) to the
handler. Each event object has properties that contain information about the event. You can use
these properties to write code that handles the event. The
Menu.menuShow event’s event object has
two additional properties:
• menuBar A reference to the MenuBar instance that is the parent of the target menu. When
the target menu does not belong to a MenuBar instance, this value is
undefined.
• menu A reference to the Menu instance that is shown.
For more information, see “EventDispatcher class” on page 415.
Example
In the following example, a handler called form is defined and passed to
myMenu.addEventListener() as the second parameter. The event object is captured by the
menuShow handler in the evt parameter. When the menuShow event is broadcast, a trace
statement is sent to the Output panel.
form = new Object();
form.menuShow = function(evt){
trace("Menu opened: "+evt.menu);