User Guide

220 Chapter 2: ActionScript Language Reference
ContextMenu.onSelect
Availability
Flash Player 7.
Usage
my_cm.onSelect = function (item:Object, item_menu:ContextMenu) : Void{
// your code here
}
Parameters
item
A reference to the object (movie clip, button, or selectable text field) that was under the
mouse pointer when the Flash Player context menu was invoked and whose
menu property is set
to a valid ContextMenu object.
item_menu A reference to the ContextMenu object assigned to the menu property of object.
Returns
Nothing.
Description
Event handler; called when a user invokes the Flash Player context menu, but before the menu is
actually displayed. This lets you customize the contents of the context menu based on the current
application state.
You can also specify the callback handler for a ContextMenu object when you construct a new
ContextMenu object. For more information, see the ContextMenu class entry.
Example
The following example determines over what type of object the context menu was invoked:
my_cm = new ContextMenu();
function menuHandler(obj:Object, menu:ContextMenu) {
if(obj instanceof MovieClip) {
trace("Movie clip: " + obj);
}
if(obj instanceof TextField) {
trace("Text field: " + obj);
}
if(obj instanceof Button) {
trace("Button: " + obj);
}
}
my_cm.onSelect = menuHandler;
my_mc.menu = my_cm;
my_btn.menu = my_cm;