Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > Button > menu (Button.menu property)

menu (Button.menu property)

Associates the ContextMenu object contextMenu with the button object my_button. The ContextMenu class lets you modify the context menu that appears when the user right-clicks (Windows) or Control-clicks (Macintosh) in Flash Player.

Availability: ActionScript 1.0; Flash Player 7

Example

The following example assigns a ContextMenu object to a button instance named myBtn_btn. The ContextMenu object contains a single menu item (labeled "Save...") with an associated callback handler function named doSave.

Add the button instance to the Stage and name it myBtn_btn.

var menu_cm:ContextMenu = new ContextMenu();
menu_cm.customItems.push(new ContextMenuItem("Save...", doSave));
function doSave(menu:Object, obj:Object):Void {
    trace( " You selected the 'Save...' menu item ");
}
myBtn_btn.menu = menu_cm;

Select Control > Test Movie to test the SWF file. With the pointer over myBtn_btn, right-click or Control-click. The context menu appears with Save in the menu. When you select Save from the menu, the Output panel appears.

See also

ContextMenu, ContextMenuItem, menu (MovieClip.menu property), menu (TextField.menu property)

Flash CS3