ContextMenu.customItems

Availability

Flash Player 7.

Usage

my_cm.customItems

Description

Property; 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 (using Array.push(), for example). For more information about creating new menu items, see the ContextMenuItem class entry.

Example

The following example creates a new custom menu item called menuItem_cm with a caption of "Send e-mail" and a callback handler named emailHandler (not shown). The new menu item is then added to the ContextMenu object, my_cm, using the customItems array. Lastly, the new menu is attached to a movie clip named email_mc.

var my_cm = new ContextMenu();
var menuItem_cm = new ContextMenuItem("Send e-mail", emailHandler);
my_cm.customItems.push(menuItem_cm);
email_mc.menu = my_cm;

See also

Button.menu, ContextMenu class, MovieClip.menu, TextField.menu