菜单数据源属性 (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)。