User Guide

734 Chapter 7: ActionScript for Flash

This property works only with selectable (editable) text fields; it has no effect on nonselectable

text fields.

In Flex, only top-level components in the application can have context menus. For example, if a

DataGrid control is a child of a TabNavigator or VBox container, the DataGrid control cannot

have its own context menu.

Example

The following example assigns the ContextMenu object menu_cm to the text field news_txt. The

ContextMenu object contains a custom menu item labeled “Resize” with an associated callback

handler named

doResize(), which could be used to add resizing functionality (not shown):

this.createTextField("news_txt", this.getNextHighestDepth(), 10, 10, 320,

240);

news_txt.border = true;

news_txt.wordWrap = true;

news_txt.multiline = true;

news_txt.text = "To see the custom context menu item, right click (PC) or

control click (Mac) within the text field.";

var menu_cm:ContextMenu = new ContextMenu();

menu_cm.customItems.push(new ContextMenuItem("Resize", doResize));

function doResize(obj:TextField, item:ContextMenuItem):Void {

// "Resize" code here

trace("you selected: "+item.caption);

}

news_txt.menu = menu_cm;

When you right-click or Control-click within the area of the text field, you see the custom menu

item.

Caution: You cannot use a menu item that is already used by Flash. For example, Print... (with three

dots) is reserved by Flash, so you cannot use this menu item; however, you could use Print.. (two

dots) or any menu item not already used by Flash.