包 | flash.display |
类 | public class NativeMenuItem |
继承 | NativeMenuItem EventDispatcher Object |
子类 | ContextMenuItem |
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
菜单项可以是一个命令、一个子菜单或一条分隔线:
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 对象。 | NativeMenuItem | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
创建 NativeMenuItem 对象的副本。 | NativeMenuItem | ||
将事件调度到事件流中。 | EventDispatcher | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
指示对象是否已经定义了指定的属性。 | Object | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
指示指定的属性是否存在、是否可枚举。 | Object | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
设置循环操作动态属性的可用性。 | Object | ||
返回一个字符串,其中包含 NativeMenuItem 对象的所有属性。 | NativeMenuItem | ||
返回指定对象的原始值。 | Object | ||
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher |
事件 | 摘要 | 定义方 | ||
---|---|---|---|---|
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | |||
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | |||
在显示包含此项目的菜单的前一刻由此 NativeMenuItem 对象调度。 | NativeMenuItem | |||
每当用户选择菜单项时调度。 | NativeMenuItem |
checked | 属性 |
checked:Boolean
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
控制此菜单项是否显示复选标记。
public function get checked():Boolean
public function set checked(value:Boolean):void
data | 属性 |
data:Object
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
与此菜单项关联的任意数据对象。
可以向此属性分配任何对象。分配的对象不会由菜单系统使用,但可供事件处理代码使用,(通过事件对象的 target 属性)。默认情况下,此属性的值为 null
。
public function get data():Object
public function set data(value:Object):void
enabled | 属性 |
enabled:Boolean
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
控制是否启用此菜单项。
public function get enabled():Boolean
public function set enabled(value:Boolean):void
isSeparator | 属性 |
isSeparator:Boolean
[只读 (read-only)] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
报告此项目是否为菜单分隔线。
通过将 NativeMenuItem 构造函数中的 isSeparator
属性设置为 true
创建一条分隔线。
public function get isSeparator():Boolean
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
keyEquivalentModifiers | 属性 |
keyEquivalentModifiers:Array
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
等效功能键的键控代码数组。
使用 Keyboard 类中定义的常数可以指定功能键代码。有效的功能键包括:
Keyboard.ALTERNATE
Keyboard.COMMAND
Keyboard.CONTROL
如果未指定任何功能键,则默认情况下,将在 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
另请参见
label | 属性 |
label:String
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
此菜单项的显示字符串。
public function get label():String
public function set label(value:String):void
menu | 属性 |
menu:NativeMenu
[只读 (read-only)] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
包含此项目的菜单。
public function get menu():NativeMenu
mnemonicIndex | 属性 |
mnemonicIndex:int
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
菜单项标签中的助记键字符的位置。
位于指定位置的字符是该菜单项的助记键字符。索引是从 0 开始的,所以第一个字符的索引为 0。
在不使用菜单助记键的操作系统中将忽略此属性。
public function get mnemonicIndex():int
public function set mnemonicIndex(value:int):void
name | 属性 |
name:String
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
此菜单项的名称。
名称值不显示,并可用作独立于区域设置的标识符。不自动分配名称。
public function get name():String
public function set name(value:String):void
submenu | 属性 |
submenu:NativeMenu
[读写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
与此菜单项关联的子菜单。
将 NativeMenu 对象分配给此属性将更改该菜单项的外观和行为。子菜单项将显示子菜单图标,并且不再调度 select 事件。
public function get submenu():NativeMenu
public function set submenu(value:NativeMenu):void
另请参见
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 。
|
另请参见
clone | () | 方法 |
toString | () | 方法 |
override public function toString():String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
返回一个字符串,其中包含 NativeMenuItem 对象的所有属性。
返回String — 一个字符串,其中包含 Event 对象的所有属性。 |
displaying | 事件 |
flash.events.Event
flash.events.Event.DISPLAYING
运行时版本: | AIR 1.0 |
在显示包含此项目的菜单的前一刻由此 NativeMenuItem 对象调度。
该事件对象的 target
属性将引用包含此 NativeMenuItem 对象的 NativeMenu 对象,currentTarget
属性将引用此 NativeMenuItem。
Event.DISPLAYING
常量定义 displaying
事件对象的 type
属性值。
注意:无论目标是否出现在显示列表中,此事件都不会通过“捕获阶段”,而是被直接调度给此目标。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles
|
false
|
cancelable
|
false
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
| 将要显示的 对象。 |
select | 事件 |
flash.events.Event
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
| 对象,已在其中选定了一个项目。 |