メニューデータソースの属性またはプロパティ

Adobe AIR 1.0 およびそれ以降

メニューデータソースのアイテムには、アイテムの表示方法と動作を決定する 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 属性が無視されます。