メニューデータソースのアイテムには、アイテムの表示方法と動作を決定する XML 属性またはオブジェクトプロパティをいくつか指定できます。次の表は、指定できる属性、属性のデータ型、用途、およびデータソースでの属性の表現方法を示します。
属性またはプロパティ
|
型
|
説明
|
altKey
|
Boolean
|
アイテムのキーボードショートカットに Alt キーを含める必要があるかどうかを指定します。
|
cmdKey
|
Boolean
|
アイテムのキーボードショートカットに Command キーを含める必要があるかどうかを指定します。この値には、
defaultKeyEquivalentModifiers
フィールドも影響します。
|
ctrlKey
|
Boolean
|
アイテムのキーボードショートカットに Control キーを含める必要があるかどうかを指定します。この値には、
defaultKeyEquivalentModifiers
フィールドも影響します。
|
defaultKeyEquivalentModifiers
|
Boolean
|
アイテムのキーボードショートカットにオペレーティングシステムのデフォルトの修飾キー(Mac OS X の場合は Command キー、Windows の場合は Ctrl キー)を含める必要があるかどうかを指定します。この属性を指定しないと、MenuBuilder フレームワークではこのアイテムの値が
true
の場合と同じように扱われます。
|
enabled
|
Boolean
|
ユーザーがメニューアイテムを選択できる場合は true、選択できない場合は false を指定します。この属性を指定しないと、MenuBuilder フレームワークではこのアイテムの値が
true
の場合と同じように扱われます。
|
商品
|
Array
|
(JSON のみ)メニューアイテム自体をメニューとして指定します。配列内のオブジェクトは、メニュー内の子メニューアイテムです。
|
keyEquivalent
|
String
|
押したときにメニューアイテムの選択イベントがトリガーされるキーボード文字を指定します。
この値が大文字である場合は、アイテムのキーボードショートカットに Shift キーを含める必要があります。
|
label
|
String
|
コントロールに表示されるテキストを指定します。このアイテムは、
separator
以外のすべてのタイプのメニューアイテムに使用します。
|
mnemonicIndex
|
Integer
|
メニューアイテムのニーモニックとして使用するラベル内の文字のインデックス位置を指定します。また、ラベル内の文字の左側にアンダースコアを挿入して、その文字がメニューアイテムのニーモニックであることを示すこともできます。
|
onSelect
|
String または Function
|
関数の名前(String)または関数への参照(Function オブジェクト)を指定します。指定した関数は、ユーザーがメニューアイテムを選択したときにイベントリスナーとして呼び出されます。詳しくは、
MenuBuilder メニューイベントの処理
を参照してください。
|
shiftKey
|
String
|
アイテムのキーボードショートカットに Shift キーを含める必要があるかどうかを指定します。
この値は、
keyEquivalent
の値によって指定される場合もあります。
keyEquivalent
の値が大文字である場合は、キーボードショートカットに Shift キーを含める必要があります。
|
toggled
|
Boolean
|
check アイテムを選択するかどうかを指定します。このプロパティを選択しないと、MenuBuilder フレームワークではアイテムの値が
false
の場合と同じように扱われ、アイテムが選択されません。
|
type
|
String
|
メニューアイテムのタイプを指定します。意味のある値は、
separator
および
check
です。MenuBuilder フレームワークでは、
type
項目がない他のすべての値、エレメントまたはオブジェクトが、normal のメニュー項目として扱われます。
|
MenuBuilder フレームワークでは、他のすべてのオブジェクトプロパティまたは XML 属性が無視されます。
|
|
|