创建本机菜单 (AIR)

Adobe AIR 1.0 和更高版本

本主题描述如何创建 AIR 所支持的各种类型的本机菜单。

创建根菜单对象

若要创建 NativeMenu 对象来充当菜单的根,请使用 NativeMenu 构造函数:

var root:NativeMenu = new NativeMenu(); 

对于应用程序菜单和窗口菜单,根菜单表示菜单栏,并且应当只包含打开子菜单的项目。上下文菜单和弹出菜单没有菜单栏,因此根菜单可以包含命令和分隔线以及子菜单。

在创建菜单之后,可以添加菜单项。除非使用菜单对象的 addItemAt() 方法在给定索引处添加项目,否则项目以添加顺序出现在菜单中。

将菜单分配为应用程序、窗口、图标或上下文菜单,或将其显示为弹出菜单,如以下几节所示:

设置应用程序菜单或窗口菜单

您的代码中应包含应用程序菜单(受 Mac OS 支持)和窗口菜单(受其他操作系统支持),这很重要

var root:NativeMenu = new NativeMenu(); 
if (NativeApplication.supportsMenu) 
{ 
    NativeApplication.nativeApplication.menu = root; 
} 
else if (NativeWindow.supportsMenu) 
{ 
    nativeWindow.menu = root; 
}
注: Mac OS 定义了一个菜单,其中包含可用于每个应用程序的标准项目。将新 NativeMenu 对象分配给 NativeApplication 对象的 menu 属性可以替换标准菜单。还可以使用标准菜单,而不是替换它。

Adobe Flex 提供了 FlexNativeMenu 类,用于方便地创建跨平台工作的菜单。如果您使用的是 Flex 框架,请使用 FlexNativeMenu 类,而不要使用 NativeMenu 类。

在交互式对象上设置上下文菜单

interactiveObject.contextMenu = root;

设置停靠栏图标菜单或系统托盘图标菜单

您的代码中应包含应用程序菜单(受 Mac OS 支持)和窗口菜单(受其他操作系统支持),这很重要

if (NativeApplication.supportsSystemTrayIcon) 
{ 
    SystemTrayIcon(NativeApplication.nativeApplication.icon).menu = root; 
} 
else if (NativeApplication.supportsDockIcon) 
{ 
    DockIcon(NativeApplication.nativeApplication.icon).menu = root; 
}
注: Mac OS X 为应用程序停靠栏图标定义了标准菜单。在将新 NativeMenu 分配给 DockIcon 对象的 menu 属性时,该菜单中的项目将显示在标准项目之上。不能删除、访问或修改标准菜单项。

以弹出方式显示菜单

root.display(stage, x, y); 

创建子菜单

若要创建子菜单,请将 NativeMenuItem 对象添加到父菜单,然后将定义子菜单的 NativeMenu 对象分配给该项目的 submenu 属性。AIR 提供了两种方式来创建子菜单项及其关联的菜单对象:

可以使用 addSubmenu() 方法在一个步骤中创建菜单项及其相关的菜单对象:

var editMenuItem:NativeMenuItem = root.addSubmenu(new NativeMenu(), "Edit"); 

也可以创建菜单项,然后单独将菜单对象分配给其 submenu 属性:

var editMenuItem:NativeMenuItem = root.addItem("Edit", false); 
editMenuItem.submenu = new NativeMenu(); 

创建菜单命令

若要创建菜单命令,请将 NativeMenuItem 对象添加到菜单,然后添加一个事件侦听器来引用实现菜单命令的函数:

var copy:NativeMenuItem = new NativeMenuItem("Copy", false); 
copy.addEventListener(Event.SELECT, onCopyCommand); 
editMenu.addItem(copy);

可以在命令项本身上侦听 select 事件(如本例中所示),也可以在父菜单对象上侦听 select 事件。

注: 表示子菜单和分隔线的菜单项不调度 select 事件,因此不能用作命令。

创建菜单分隔线

若要创建分隔线,请创建 NativeMenuItem,并在构造函数中将 isSeparator 参数设置为 true 。然后,将分隔符项目添加到菜单中的正确位置:

var separatorA:NativeMenuItem = new NativeMenuItem("A", true); 
editMenu.addItem(separatorA);

不显示为分隔符指定的标签(如果有)。