| window.runtime 属性 | window.runtime.flash.display.NativeMenuItem |
| 继承 | NativeMenuItem EventDispatcher Object |
菜单项可以是一个命令、一个子菜单或一条分隔线:
isSeparator 参数传递 false。submenu 属性。也可以调用父级 NativeMenu 对象的 addSubmenu() 方法来创建该项并同时设置 submenu 属性。isSeparator 参数传递 true。在一个项目或父菜单上侦听 select 事件可以检测何时选择某一菜单命令。子菜单和分隔符都不调度 select 事件。侦听 displaying 事件可以确定何时显示某一菜单项。
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
| checked : Boolean
控制此菜单项是否显示复选标记。 | NativeMenuItem | ||
![]() | constructor : 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 | ||
![]() | prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | |
| submenu : NativeMenu
与此菜单项关联的子菜单。 | NativeMenuItem | ||
| 方法 | 定义方 | ||
|---|---|---|---|
NativeMenuItem(label:String = "", isSeparator:Boolean = false)
创建新的 NativeMenuItem 对象。 | NativeMenuItem | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | |
创建 NativeMenuItem 对象的副本。 | NativeMenuItem | ||
![]() | dispatchEvent(event:Event):Boolean
将事件调度到事件流中。 | EventDispatcher | |
![]() | hasEventListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
![]() | hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。 | Object | |
![]() | isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
![]() | propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。 | Object | |
![]() | removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
![]() | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。 | Object | |
toString():String
返回一个字符串,其中包含 NativeMenuItem 对象的所有属性。 | NativeMenuItem | ||
![]() | valueOf():Object
返回指定对象的原始值。 | Object | |
![]() | willTrigger(type:String):Boolean
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher | |
| 事件 | 摘要 | 定义方 | ||
|---|---|---|---|---|
![]() | Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时调度。 | EventDispatcher | ||
![]() | Flash 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 类中定义的常数可以指定功能键代码。有效的功能键包括:
Keyboard.ALTERNATEKeyboard.COMMANDKeyboard.CONTROL如果未指定任何修饰符,则默认情况下,将在 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 | () | 方法 |
| toString | () | 方法 |
function toString():String返回一个字符串,其中包含 NativeMenuItem 对象的所有属性。
返回String — 一个字符串,其中包含 Event 对象的所有属性。
|
| displaying | 事件 |
flash.events.Eventflash.events.Event.DISPLAYING在显示包含此项目的菜单的前一刻由此 NativeMenuItem 对象调度。
该事件对象的 target 属性将引用包含此 NativeMenuItem 对象的 NativeMenu 对象,currentTarget 属性将引用此 NativeMenuItem。
Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。
注意:无论目标是否出现在显示列表中,此事件都不会通过“捕获阶段”,而是被直接调度给此目标。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 将要显示的 对象。 |
| select | 事件 |
flash.events.Eventflash.events.Event.SELECT每当用户选择菜单项时调度。
select 事件将从此项目冒泡 到包含菜单,并贯穿父菜单链到达根菜单对象。该事件对象的 target 属性将引用此 NativeMenuItem 对象;currentTarget 属性将引用调度对象(此 NativeMenuItem 或祖先级 NativeMenu 对象)。
注意:如果包含该菜单的窗口处于全屏模式,则当用户输入键盘等效项作为菜单项时,NativeMenuItem 对象不会 调度 select 事件。不过,可以侦听由 NativeWindow 对象的 stage 属性调度的 keyDown 事件。
Event.SELECT 常量定义 select 事件对象的 type 属性的值。
此事件具有以下属性:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 对象,已在其中选定了一个项目。 |