window.runtime 属性window.runtime.flash.display.NativeMenuItem
继承NativeMenuItem Inheritance EventDispatcher Inheritance Object

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

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

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

另请参见

NativeMenu
NativeMenu.addSubmenu()


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

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

data属性 
data:Object  [读写]

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

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

enabled属性 
enabled:Boolean  [读写]

控制是否启用此菜单项。

isSeparator属性 
isSeparator:Boolean  [只读 (read-only)]

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

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

keyEquivalent属性 
keyEquivalent:String  [读写]

此菜单项的等效键。

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

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

keyEquivalentModifiers属性 
keyEquivalentModifiers:Array  [读写]

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

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

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

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

另请参见

label属性 
label:String  [读写]

此菜单项的显示字符串。

menu属性 
menu:NativeMenu  [只读 (read-only)]

包含此项目的菜单。

mnemonicIndex属性 
mnemonicIndex:int  [读写]

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

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

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

name属性 
name:String  [读写]

此菜单项的名称。

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

submenu属性 
submenu:NativeMenu  [读写]

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

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

另请参见

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

创建新的 NativeMenuItem 对象。

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

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

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

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

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

另请参见

方法详细信息
clone()方法
function clone():NativeMenuItem

创建 NativeMenuItem 对象的副本。

返回
NativeMenuItem
toString()方法 
function toString():String

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

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

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

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

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

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

此事件具有以下属性:

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

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

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

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

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

此事件具有以下属性:

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