NativeMenuItem  - AS3

控制此菜单项是否显示复选标记。

与此菜单项关联的任意数据对象。

可以向此属性分配任何对象。分配的对象不会由菜单系统使用，但可供事件处理代码使用，（通过事件对象的 target 属性）。默认情况下，此属性的值为 null。

控制是否启用此菜单项。

报告此项目是否为菜单分隔线。

通过将 NativeMenuItem 构造函数中的 isSeparator 属性设置为 true 创建一条分隔线。

此菜单项的等效键。

使用小写字母设置 keyEquivalent 可以分配无 Shift 功能键的快捷键。使用大写字母设置此属性可以分配具有 Shift 功能键的快捷键。

默认情况下，等效功能键（Windows 或 Linux 中为 Ctrl，Mac OS X 中为 Command）作为等效键的一部分包括在内。如果希望等效键是一个没有修饰符的键，可将 keyEquivalentModifiers 属性设置为一个空数组。

等效功能键的键控代码数组。

使用 Keyboard 类中定义的常量可以指定功能键代码。有效的功能键包括：

• Keyboard.ALTERNATE
• Keyboard.COMMAND
• Keyboard.CONTROL

如果未指定任何功能键，则默认情况下，将在 Windows 或 Linux 中分配 Keyboard.CONTROL 键，在 Mac OS X 中分配 Keyboard.COMMAND 键。如果不希望等效键包括这些功能键，可将此属性设置为空数组。

如果为 keyEquivalent 属性分配一个大写字母，则会自动将 Shift 键用作修饰符。将 keyEquivalentModifier 设置为一个空数组不会撤消将 Shift 键用作修饰符。

相关 API 元素

此菜单项的显示字符串。

包含此项目的菜单。

菜单项标签中的助记键字符的位置。

位于指定位置的字符是该菜单项的助记键字符。索引是从 0 开始的，所以第一个字符的索引为 0。

在不使用菜单助记键的操作系统中将忽略此属性。

此菜单项的名称。

名称值不显示，并可用作独立于区域设置的标识符。不自动分配名称。

与此菜单项关联的子菜单。

将 NativeMenu 对象分配给此属性将更改该菜单项的外观和行为。子菜单项将显示子菜单图标，并且不再调度 select 事件。

注意：将菜单添加为其自身的一个子菜单（在循环引用中）可能导致应用程序挂起。

相关 API 元素

创建新的 NativeMenuItem 对象。

要创建一个菜单命令，请将 label 参数设置为包含该显示标签的字符串，并将 isSeparator 设置为 false。

要创建一个子菜单命令，请创建一个命令项，然后将子菜单的 NativeMenu 对象分配给该命令项的 submenu 属性。将该项添加到父菜单。

要创建一个分隔符，请将 label 参数设置为空字符串，并将 isSeparator 设置为 true。

使用 NativeMenu addItem() 和 removeItem() 方法在菜单中添加和删除项目。

相关 API 元素

创建 NativeMenuItem 对象的副本。

返回一个字符串，其中包含 NativeMenuItem 对象的所有属性。

在显示包含此项目的菜单的前一刻由此 NativeMenuItem 对象调度。

preparing 事件替代 displaying 事件并提供其他功能。侦听 preparing 事件或 displaying 事件，但不能同时侦听两者。

注意：无论目标是否出现在显示列表中，此事件都不会通过“捕获阶段”，而是被直接调度给此目标。

此事件具有以下属性：

在包含它的菜单显示之前的一瞬间且按下其等效键时由此 NativeMenuItem 对象调度。

在包含它的菜单显示之前或用户按下其等效键时，侦听此事件以更新该项。在完全计算等效键之前调度 preparing 事件。您可以在 preparing 事件处理函数中从菜单中启用、禁用或删除菜单项，这些更改将在处理等效键时生效。例如，如果您删除或禁用此菜单项，则事件顺序将有效地被取消，不调度 select 事件。preparing 事件还由菜单中的其他项调度。

preparing 事件替代 displaying 事件并提供其他功能。侦听 preparing 事件或 displaying 事件，但不能同时侦听两者。

注意：无论目标是否出现在显示列表中，此事件都不会通过“捕获阶段”，而是被直接调度给此目标。

此事件具有以下属性：

每当用户选择菜单项时调度。

select 事件将从此项目冒泡 到包含菜单，并贯穿父菜单链到达根菜单对象。该事件对象的 target 属性将引用此 NativeMenuItem 对象；currentTarget 属性将引用调度对象（此 NativeMenuItem 或祖先级 NativeMenu 对象）。

注意：如果包含该菜单的窗口处于全屏模式 (stage.displayState == StageDisplayState.FULL_SCREEN)，则当用户输入菜单项的键盘等效项时，NativeMenuItem 对象不会 调度 select 事件。

此事件具有以下属性：