User Guide

ManualsBrandsMacromedia ManualsOtherFLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

891

892

893

894

895

896

897

898

899

900

TextField.menu 897

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.

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.