データプロバイダ内のデータにアクセスして操作するオブジェクトです。MenuBar コントロールは、データに関する情報について、データ記述子に委任します。次に、このデータはデータソースに関する解析と移動のために使用されます。MenuBar に対して定義されたデータ記述子は、すべての子メニューおよびサブメニューで使用されます。

このプロパティを MXML の属性として指定する場合、記述子のストリング名ではなく、データ記述子への参照を使用する必要があります。プロパティを設定するには次の形式を使用します。

<mx:MenuBar id="menubar" dataDescriptor="{new MyCustomDataDescriptor()}"/>

また、次の例に示すように、ネストしたサブタグとして MXML のプロパティを指定できます。

<mx:MenuBar>
      <mx:dataDescriptor>
         <myCustomDataDescriptor>
      </mx:dataDescriptor>
      ...

デフォルト値は、DefaultDataDescriptor クラスの内部インスタンスです。

MenuBar のアイテムとメニューとして表示されるオブジェクトの階層です。最上位の子はすべて MenuBar アイテムになり、その子はメニューとサブメニュー内のアイテムになります。 MenuBar コントロールは、ソースデータオブジェクトを次のように処理します。

• 有効な XML テキストを含むストリングが XML オブジェクトに変換されます。
• XMLNode は、XML オブジェクトに変換されます。
• また XMLList は、XMLListCollection に変換されます。
• ICollectionView インターフェイスを実装するすべてのオブジェクトが ICollectionView にキャストされます。
• Array は ArrayCollection に変換されます。
• 他のタイプのオブジェクトは、Array 内でその単一エントリとしてラップされます。

デフォルト値"undefined".

このプロパティはデータバインディングのソースとして使用できます。

現在のデータプロバイダにルートノード (たとえば、階層構造内の単一の最上位ノードなど) があることを示すフラグ。XML と Object はルートノードがあるタイプの例であり、リストと配列はルートノードがないタイプの例です。

各メニューアイテムに表示されるアイコンを決定するデータプロバイダのフィールド名です。デフォルトでは、MenuBar は、メニューアイテム内のテキストにはアイコンが表示されません。アイコンフィールドを指定することで、メニューアイテムのアイコンとして作成、表示されるグラフィックを定義できます。

MenuItemRenderer は、iconField プロパティによって定義された名前のプロパティのデータプロバイダを調べます。プロパティの値が Class である場合は、そのクラスをインスタンス化し、それが IFlexDisplayObject のインスタンスになると想定します。プロパティの値が String である場合は、その名前を持つ Class がアプリケーションに存在するかどうかを確認します。該当する Class が見つからない場合は、その名前を持つプロパティをドキュメントで確認し、そのプロパティが Class にマップされると想定します。

デフォルト値"icon".

このプロパティはデータバインディングのソースとして使用できます。

各メニューアイテムに表示されるテキストを決定するデータプロバイダのフィールド名です。データプロバイダがストリングの配列である場合、各ストリング値がラベルとして使用されます。データプロバイダが E4X XML オブジェクトの場合、このプロパティを明示的に設定する必要があります。たとえば、

デフォルト値"label".

このプロパティはデータバインディングのソースとして使用できます。

各メニューアイテムに表示するテキストを判定する関数です。ラベル関数でデータプロバイダ内の適切なフィールドを検索し、表示可能なストリングを返す必要があります。 このプロパティを省略すると、labelField プロパティで指定したフィールドまたは属性の値が使用されます。このプロパティを指定した場合、labelField プロパティの値は無視されます。labelFunction プロパティは、フォーマット処理やローカライズにも使用できます。

このラベル関数は単一のパラメータを取得します。このパラメータは、データプロバイダ内のアイテムであり、String を返します。

      myLabelFunction(item:Object):String 

デフォルト値"undefined".

MenuBar コントロールの最上位メニューバーのための、MenuBar コントロールによって使用されるアイテムレンダラーです。

MenuBar コントロールのポップアップサブメニューのアイテムレンダラーを定義できます。各ポップアップサブメニューは Menu コントロールのインスタンスであるため、MenuItemRenderer クラスを使用して、ポップアップサブメニューのアイテムレンダラーを定義します。ポップアップサブメニューのアイテムレンダラーを設定するには、menus プロパティを使用して Menu オブジェクトにアクセスします。

デフォルト値"mx.controls.menuClasses.MenuBarItem".

このプロパティはデータバインディングのソースとして使用できます。

関連項目

MenuBar コントロールの最上位メニューバーで、各アイテムをレンダリングする MenuBarItem オブジェクトを含む配列です。デフォルトでは、このプロパティには MenuBarItem クラスのインスタンスが含まれます。 アイテムは、menuBarItems 配列に直接追加しないでください。新しいメニューバーアイテムを追加するには、MenuBar コントロールのデータプロバイダに直接追加します。

デフォルト値[ ].

関連項目

この MenuBar コントロールのポップアップサブメニューに対応する Menu オブジェクトを含む配列です。各 MenuBar アイテムは、ポップアップサブメニューを持たない場合でも、この配列内に対応する Menu オブジェクトを持つことができます。menus 配列は最初から設定されるのではなく、必要に応じてメニューが動的に作成されます。 アイテムは、menus 配列に直接追加しないでください。新しいドロップダウンメニューを追加するには、MenuBar コントロールのデータプロバイダに直接追加します。

デフォルト値[ ].

現在開いている Menu、または現在開いている Menu がない場合は最後に開いていた Menu の MenuBar コントロールのインデックスです。

デフォルト値-1.

このプロパティはデータバインディングのソースとして使用できます。

データプロバイダのルートノードを表示するかどうかを指定する Boolean フラグです。データプロバイダにルートノードがあり、showRoot プロパティが false に設定されている場合、MenuBar コントロールのアイテムはルートノードの直下の子孫に対応します。 このフラグは、リストや配列などのルートノードがないデータプロバイダには影響しません。

デフォルト値true.

関連項目

コンストラクタ

指定した MenuBar アイテムインデックスの Menu オブジェクトへの参照を返します。0 は、左端の MenuBar アイテムインデックスの位置にある Menu です。

データアイテムにクラスのアイコンがあれば、iconField プロパティに基づいてそのクラスを返します。アイテム内のフィールドは、ストリングがアプリケーション内のクラスの名前を表している限り、そのストリングを返すことができます。また、アイテム内のフィールドは、アイコンのクラスを保持しているドキュメント内の変数の名前であるストリングにすることもできます。

labelField プロパティと labelFunction プロパティに基づいて、指定されたデータオブジェクトに対してレンダラーが表示するストリングを返します。メソッドがパラメータをストリングに変換できない場合、1 つのスペースを返します。

MenuBar アイテムのデフォルトの幅に基づいて、MenuBar の適切な幅と高さを計算します。

MenuBar コントロールの背景のスキンを更新します。 このメソッドは、MenuBar の子が作成された、または MenuBar のスタイルが変更されたときに呼び出されます。

ユーザー操作の結果として選択が変更されたときに送出されます。また、このイベントはユーザーがポップアップサブメニューで現在のメニュー選択を変更したときにも送出されます。メニューバーでイベントが発生するとき、MenuEvent オブジェクトの menu プロパティは null です。ポップアップサブメニューでイベントが発生するとき、menu プロパティにはポップアップサブメニューである Menu オブジェクトへの参照が含まれます。

MenuEvent.CHANGE イベント型定数は、ユーザー操作の結果として選択が変更されたことを示します。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。

ユーザーがポップアップサブメニューからアイテムを選択したときに送出されます。

MenuEvent.ITEM_CLICK イベント型定数は、ユーザーがメニューアイテムを選択したことを示します。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。

カーソルがメニューアイテムから離れるときに送出されます。

この MenuEvent.ITEM_ROLL_OUT 型定数は、マウスポインタがメニューアイテム外に移動したことを示します。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。

メニューアイテム上にマウスポインタが置かれたときに送出されます。

この MenuEvent.ITEM_ROLL_OVER 型定数は、マウスポインタがメニューアイテム上に置かれたことを示します。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。

ポップアップサブメニューが閉じたときに送出されます。

この MenuEvent.MENU_HIDE 型定数は、メニューまたはサブメニューが閉じたことを示します。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。

ポップアップサブメニューが開かれたとき、またはドロップダウンメニューを持たないメニューバーアイテムをユーザーが選択したときに送出されます。

この MenuEvent.MENU_SHOW 型定数は、マウスポインタがメニュー上に置かれたか、サブメニューが開かれたことを示します。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。