TextField.menu

Availability

Flash Player 7.

Usage

my_txt.menu = contextMenu

Parameters

contextMenu A ContextMenu object.

Description

Property; associates the ContextMenu object contextMenu with the text field my_txt. The ContextMenu class lets you modify the context menu that appears when the user right-clicks (Windows) or Control-clicks (Macintosh) in Flash Player.

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

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.