User Guide

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");

}