(仅限 AIR)
flash.display
public class NativeMenuItem
继承NativeMenuItem Inheritance EventDispatcher Inheritance Object
子类 ContextMenuItem

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

NativeMenuItem 类表示菜单中的单个项目。

菜单项可以是一个命令、一个子菜单或一条分隔线:

在一个项目或父菜单上侦听 select 事件可以检测何时选择某一菜单命令。子菜单和分隔符都不调度 select 事件。侦听 displaying 事件可以确定何时显示某一菜单项。

另请参见

flash.display.NativeMenu
flash.display.NativeMenu.addSubmenu()


公共属性
 属性定义方
  AIR-only checked : Boolean
控制此菜单项是否显示复选标记。
NativeMenuItem
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  AIR-only data : Object
与此菜单项关联的任意数据对象。
NativeMenuItem
  AIR-only enabled : Boolean
控制是否启用此菜单项。
NativeMenuItem
  AIR-only isSeparator : Boolean
[只读 (read-only)] 报告此项目是否为菜单分隔线。
NativeMenuItem
  AIR-only keyEquivalent : String
此菜单项的等效键。
NativeMenuItem
  AIR-only keyEquivalentModifiers : Array
等效功能键的键控代码数组。
NativeMenuItem
  AIR-only label : String
此菜单项的显示字符串。
NativeMenuItem
  AIR-only menu : NativeMenu
[只读 (read-only)] 包含此项目的菜单。
NativeMenuItem
  AIR-only mnemonicIndex : int
菜单项标签中的助记键字符的位置。
NativeMenuItem
  AIR-only name : String
此菜单项的名称。
NativeMenuItem
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  AIR-only submenu : NativeMenu
与此菜单项关联的子菜单。
NativeMenuItem
公共方法
 方法定义方
  
AIR-only NativeMenuItem(label:String = "", isSeparator:Boolean = false)
创建新的 NativeMenuItem 对象。
NativeMenuItem
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
  
创建 NativeMenuItem 对象的副本。
NativeMenuItem
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
  
返回一个字符串,其中包含 NativeMenuItem 对象的所有属性。
NativeMenuItem
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
  在显示包含此项目的菜单的前一刻由此 NativeMenuItem 对象调度。NativeMenuItem
  每当用户选择菜单项时调度。NativeMenuItem
属性详细信息
AIR-only checked属性
checked:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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



实现
    public function get checked():Boolean
    public function set checked(value:Boolean):void
AIR-only data属性 
data:Object  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

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



实现
    public function get data():Object
    public function set data(value:Object):void
AIR-only enabled属性 
enabled:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

控制是否启用此菜单项。



实现
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
AIR-only isSeparator属性 
isSeparator:Boolean  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

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



实现
    public function get isSeparator():Boolean
AIR-only keyEquivalent属性 
keyEquivalent:String  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

此菜单项的等效键。

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

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



实现
    public function get keyEquivalent():String
    public function set keyEquivalent(value:String):void
AIR-only keyEquivalentModifiers属性 
keyEquivalentModifiers:Array  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

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

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

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



实现
    public function get keyEquivalentModifiers():Array
    public function set keyEquivalentModifiers(value:Array):void

另请参见

AIR-only label属性 
label:String  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

此菜单项的显示字符串。



实现
    public function get label():String
    public function set label(value:String):void
AIR-only menu属性 
menu:NativeMenu  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

包含此项目的菜单。



实现
    public function get menu():NativeMenu
AIR-only mnemonicIndex属性 
mnemonicIndex:int  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

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

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



实现
    public function get mnemonicIndex():int
    public function set mnemonicIndex(value:int):void
AIR-only name属性 
name:String  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

此菜单项的名称。

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



实现
    public function get name():String
    public function set name(value:String):void
AIR-only submenu属性 
submenu:NativeMenu  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

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



实现
    public function get submenu():NativeMenu
    public function set submenu(value:NativeMenu):void

另请参见

构造函数详细信息
AIR-only NativeMenuItem()构造函数
public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

创建新的 NativeMenuItem 对象。

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

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

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

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

参数
label:String (default = "") — 用于该项目的显示标签,或用于分隔符的空字符串。
 
isSeparator:Boolean (default = false) — 设置为 true 可创建分隔符;否则设置为 false

另请参见

方法详细信息
AIR-only clone()方法
public function clone():NativeMenuItem

运行时版本: AIR 1.0

创建 NativeMenuItem 对象的副本。

返回
NativeMenuItem
AIR-only toString()方法 
override public function toString():String

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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

返回
String — 一个字符串,其中包含 Event 对象的所有属性。
事件详细信息
AIR-only displaying 事件
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.DISPLAYING

运行时版本: AIR 1.0

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

该事件对象的 target 属性将引用包含此 NativeMenuItem 对象的 NativeMenu 对象,currentTarget 属性将引用此 NativeMenuItem。

Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。

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

此事件具有以下属性:

属性
bubbles false
cancelable false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
target 将要显示的 对象。
AIR-only select 事件  
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.SELECT

运行时版本: AIR 1.0

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

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

注意:如果包含该菜单的窗口处于全屏模式,则当用户输入键盘等效项作为菜单项时,NativeMenuItem 对象不会 调度 select 事件。不过,可以侦听由 NativeWindow 对象的 stage 属性调度的 keyDown 事件。

Event.SELECT 常量定义 select 事件对象的 type 属性的值。

此事件具有以下属性:

属性
bubbles false
cancelable false;没有要取消的默认行为。
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
target 对象,已在其中选定了一个项目。