User Guide

218 Chapter 2: ActionScript Language Reference

ContextMenu.customItems

Availability

Flash Player 7.

Usage

my_cm.customItems:Array

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 (for example, using Array.push()). 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. 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.

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

}