菜单数据源中的项目可以指定几个 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)。
|
|
|