MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 345 / 816

ContextMenuItem.separatorBefore 345
Description
Event handler; invoked when the specified menu item is selected from the Flash Player context
menu. The specified callback handler receives two parameters:
obj
, a reference to the object
under the mouse when the user invoked the Flash Player context menu, and
menuItem
, a
reference to the ContextMenuItem object that represents the selected menu item.
Example
The following example assigns a function to the
onSelect
handler for a ContextMenuItem
object named
start_cmi
. The function displays the caption of the selected menu item.
start_cmi.onSelect = function (obj, item) {
trace("You choose: " + item.caption);
}
See also
ContextMenu.onSelect
ContextMenuItem.separatorBefore
Availability
Flash Player 7.
Usage
menuItem_cmi .separatorBefore
Description
Property; a Boolean value that indicates whether a separator bar should appear above the specified
menu item. By default, this property is
false
.
Note: A separator bar always appears between any custom menu items and the built-in menu items.
Example
This example creates three menu items labeled Open, Save, and Print. A separator bar divides the
Save and Print items. The menu items are then added to the ContextMenu object’s
customItems
array. Lastly, the menu is attached to the root Timeline of the SWF file.
my_cm = new ContextMenu();
open_cmi = new ContextMenuItem("Open", itemHandler);
save_cmi = new ContextMenuItem("Save", itemHandler);
print_cmi = new ContextMenuItem("Print", itemHandler);
print_cmi.separatorBefore = true;
my_cm.customItems.push(open_cmi, save_cmi, print_cmi);
function itemHandler(obj, menuItem) {
trace("You chose: " + menuItem.caption);
};
_root.menu = my_cm;
See also
ContextMenu.onSelect