User Guide

140 Chapter 2: ActionScript Language Reference

Button.menu

Availability

Flash Player 7.

Usage

my_btn.menu = contextMenu

Parameters

contextMenu

A ContextMenu object.

Description

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.

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.