菜单数据源属性 (attribute) 或属性 (property)

Adobe AIR 1.0 和更高版本

菜单数据源中的项目可以指定几个 XML 属性 (attribute) 或对象属性 (property),用于确定项目的显示和行为方式。下表列出了可以指定的属性、其数据类型、其用途以及数据源必须如何表示它们:

属性 (attribute) 或属性 (property)

类型

说明

altKey

Boolean

指定 Alt 键是否作为项目的等效键的必要组成部分。

cmdKey

Boolean

指定 Command 键是否作为项目的等效键的必要组成部分。 defaultKeyEquivalentModifiers 字段也会影响此值。

ctrlKey

Boolean

指定 Ctrl 键是否作为项目的等效键的必要组成部分。 defaultKeyEquivalentModifiers 字段也会影响此值。

defaultKeyEquivalentModifiers

Boolean

指定操作系统的默认功能键(Mac OS X 的 Command 和 Windows 的 Ctrl)是否作为项目的等效键的必要组成部分。如果不指定,则 MenuBuilder 框架将该项目的值视为 true

enabled

Boolean

指定用户是 (true) 否 (false) 可以选择菜单项。如果不指定,则 MenuBuilder 框架将该项目的值视为 true

items

Array

(仅适用于 JSON)指定菜单项本身是菜单。数组中的对象是包含于菜单中的子菜单项。

keyEquivalent

String

指定在按下时将触发像选择菜单项那样的事件的键盘字符。

如果此值是大写字符,则 Shift 键是项目的等效键的必要组成部分。

label

String

指定在控件中显示的文本。此项目用于除 separator 以外的所有菜单项类型。

mnemonicIndex

Integer

指定用作菜单项助记键的字符在标签中的索引位置。另外,还可以指示标签中的字符作为菜单项的助记键,方法是在紧靠该字符的左侧包括下划线。

onSelect

String 或 Function

指定函数 (String) 的名称或对该函数(Function 对象)的引用。当用户选择菜单项时,所指定的函数将作为事件侦听器被调用。有关详细信息,请参阅 处理 MenuBuilder 菜单事件

shiftKey

String

指定 Shift 键是否作为项目的等效键的必要组成部分。

另外, keyEquivalent 值也可以指定此值。如果 keyEquivalent 值是大写字母,则 Shift 键是等效键的必要部分。

toggled

Boolean

指定是否选中了复选项。如果不指定,则 MenuBuilder 框架将该项目的值视为 false 并且未选中此项目。

type

String

指定菜单项的类型。有意义的值是 separator check 。MenuBuilder 框架将其他所有值、或没有 type 条目的元素或对象均视为正常菜单条目。

MenuBuilder 框架忽略其他所有对象属性 (property) 或 XML 属性 (attribute)。