MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 447 / 1378

ContextMenu 447
}
for (var i in my_cm.customItems) {
trace("my_cm-> "+my_cm.customItems[i].caption);
}
customItems (ContextMenu.customItems property)
public customItems : Array
An array of ContextMenuItem objects. Each object in the array represents a context menu
item that you have defined. Use this property to add, remove, or modify these custom menu
items.
To add new menu items, you first create a new ContextMenuItem object, and then add it to
the
menu_mc .customItems
array (for example, using
Array.push()
). For more information
about creating new menu items, see the ContextMenuItem class entry.
Availability: ActionScript 1.0; Flash Player 7
Example
The following example creates a new custom menu item called
menuItem_cmi
with a caption
of "Send e-mail" and a callback handler named
emailHandler
. The new menu item is then
added to the ContextMenu object,
my_cm
, using the
customItems
array. Finally, the new
menu is attached to a movie clip named
email_mc
. To make this example work, create a
movie clip instance on your stage, and use the Property Inspector to name the instance
email_mc
. In Test Movie mode, the new context menu item will appear if you bring up the
context menu while your pointer is over the
email_mc
movie clip.
var my_cm:ContextMenu = new ContextMenu();
var menuItem_cmi:ContextMenuItem = new ContextMenuItem("Send e-mail",
emailHandler);
my_cm.customItems.push(menuItem_cmi);
email_mc.menu = my_cm;
function emailHandler() {
trace("sending email");
}
See also
menu (Button.menu property)
,
menu (MovieClip.menu property)
,
menu
(TextField.menu property)
,
push (Array.push method)