ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with menus
Attaching an object to a menu item
Adobe AIR 1.0 and later
The data property of the NativeMenuItem class allows you to reference an arbitrary object in each item. For example,
in an “Open Recent” menu, you could assign the File object for each document to each menu item.
var file:File = File.applicationStorageDirectory.resolvePath("GreatGatsby.pdf")
var menuItem:NativeMenuItem = docMenu.addItem(new NativeMenuItem(file.name));
menuItem.data = file;
Creating native menus (AIR)
Adobe AIR 1.0 and later
This topic describes how to create the various types of native menu supported by AIR.
Creating a root menu object
Adobe AIR 1.0 and later
To create a NativeMenu object to serve as the root of the menu, use the NativeMenu constructor:
var root:NativeMenu = new NativeMenu();
For application and window menus, the root menu represents the menu bar and should only contain items that open
submenus. Context menu and pop-up menus do not have a menu bar, so the root menu can contain commands and
separator lines as well as submenus.
After the menu is created, you can add menu items. Items appear in the menu in the order in which they are added,
unless you add the items at a specific index using the addItemAt() method of a menu object.
Assign the menu as an application, window, icon, or context menu, or display it as a pop-up menu as shown in the
following sections:
Setting the application menu or window menu
It’s important that your code accommodate both application menus (supported on Mac OS) and window menus
(supported on other operating systems)
var root:NativeMenu = new NativeMenu();
if (NativeApplication.supportsMenu)
{
NativeApplication.nativeApplication.menu = root;
}
else if (NativeWindow.supportsMenu)
{
nativeWindow.menu = root;
}
Note: Mac OS defines a menu containing standard items for every application. Assigning a new NativeMenu object to
the menu property of the NativeApplication object replaces the standard menu. You can also use the standard menu
instead of replacing it.
Last updated 6/6/2012
638