メソッド | プロパティ | エフェクト | イベント | スタイル | フレームあり | フレームなし

mx.controls
MenuBar クラス

継承を示す線継承を示す線


MenuBar クラス
mx.core.UIComponent の拡張

MenuBar コントロールは、複数のメニューを含む水平メニューバーを定義します。MenuBar コントロールは、通常は常に表示されています。これはポップアップとして使用することを目的としていません。個々のメニューは、ユーザーがクリックするとポップアップし、メニューアイテムまたはメニューの外側がクリックされると消えます。

MXML シンタックス

<mx:MenuBar> タグは、親クラスのすべてのプロパティと、次のプロパティを継承します。

 <mx:MenuBar
dataProvider="No default."
labelField="No default."
menuHide="Event handler.No default."
change="Event handler.No default."
menushow="Event handler.No default."
rollOut="Event handler.No default."
rollOver="Event handler.No default."
/>

を参照するにはここをクリックしてください

メソッド
       addMenu( arg1, arg2) :  mx.controls.Menu
1 つのメニューを MenuBar コントロールの末尾に追加し、MenuBar コントロール内の新規メニューへの参照を返します。
       addMenuAt( index, arg1, arg2) :  Void
MenuBar コントロールの指定の位置にメニューを追加します。
       getMenuAt( index) :  mx.controls.Menu
指定されたインデックスにあるメニューアイテムへの参照を返します。
       getMenuEnabledAt( index)
指定されたインデックスにあるメニューアイテムが有効にされている場合に true を返します。
       labelFunction
各メニューアイテムに表示するテキストを判定する関数です。
       layoutChildren( ) :  Void
MenuBar 上にあるアイテムのサイズと位置を設定します。
       measure( ) :  Void
MenuBar のデフォルトの高さと幅は 550x22 と指定されています。
       removeMenuAt( index) :  mx.controls.Menu
指定されたメニューを MenuBar コントロールから削除します。
       setMenuEnabledAt( index, enable)
指定されたインデックスにあるメニューアイテムを有効または無効にします。

mx.core.UIComponent クラスから継承されるメソッド
drawFocus   getFocus   getFocusManager   setEnabled   setFocus  

mx.core.UIObject クラスから継承されるメソッド
addEventListener   applyProperties   buildDepthTable   commitProperties   constructObject2   createAccessibilityImplementation   createChildAtDepth   createChildren   createClassChildAtDepth   createClassObject   createEmptyObject   destroyObject   dispatchEvent   doLater   draw   drawRect   executeBindings   fillRect   findNextAvailableDepth   getRepeaterItem   getStyle   handleEvent   init   invalidate   invalidateLayout   invalidateProperties   invalidateSize   invalidateStyle   layoutChildren   measure   move   redraw   removeEventListener   setDepthAbove   setDepthBelow   setMask   setSize   setSizeNoLayout   setStyle   swapDepths  



プロパティ
       dataProvider:Object
メニューとして表示するオブジェクトの階層です。
       labelField:String
各メニューアイテムのテキストとして使用する dataProvider の Array 内のフィールドの名前です。
staticversion:String
このクラスのバージョンを表すストリングです。

mx.core.UIComponent クラスから継承されるプロパティ
enabled   errorString   tabEnabled   tabIndex   version  

mx.core.UIObject クラスから継承されるプロパティ
alpha   baselinePosition   className   depth   documentDescriptor   height   heightFlex   id   instanceIndices   isDocument   kStretch   layoutHeight   layoutWidth   maxHeight   maxWidth   minHeight   minWidth   mouseX   mouseY   nestLevel   oldHeight   oldWidth   oldX   oldY   parent   parentApplication   parentDocument   percentHeight   percentWidth   preferredHeight   preferredWidth   repeaterIndices   scaleX   scaleY   styleName   tabEnabled   toolTip   version   visible   width   widthFlex   x   y  



エフェクト

mx.core.UIComponent クラスから継承されるエフェクト
focusInEffect   focusOutEffect  

mx.core.UIObject クラスから継承されるエフェクト
creationCompleteEffect   hideEffect   mouseDownEffect   mouseOutEffect   mouseOverEffect   mouseUpEffect   moveEffect   resizeEffect   showEffect  



イベント
changeユーザーが Menu コントロール内のアイテムを選択したときにブロードキャストされます。このイベントオブジェクトには、次のプロパティが含まれます。
- menuBar 選択された Menu コントロールの親である MenuBar インスタンスです。ターゲット Menu コントロールが MenuBar コントロールに属さない場合は、undefined です。
- menu Menu タイプの隠された Menu インスタンスです。
- menuItem 選択されたメニューアイテムです。次の形式でメニューアイテムプロパティにアクセスします。
eventobj.menuItem.attributes.attribName
- groupName アイテムが属するラジオグループの名前です。ターゲットアイテムがラジオボタングループ内に存在しない場合は undefined です。データ型は String です。
- target イベントをトリガしたコンポーネントへの参照です。
- type イベントの名前である change です。
menuHideメニューまたはサブメニューが非表示にされたときにブロードキャストされます。このイベントオブジェクトには、次のプロパティが含まれます。
- menuBar 選択された Menu コントロールの親である MenuBar インスタンスです。ターゲット Menu コントロールが MenuBar コントロールに属さない場合は、undefined です。
- target イベントをトリガしたコンポーネントへの参照です。
- type イベントの名前である menuHide です。
menuShowメニュー全体またはサブメニューが開いたときにブロードキャストされます。このイベントオブジェクトには、次のプロパティが含まれます。
- menuBar 選択された Menu コントロールの親である MenuBar インスタンスです。ターゲット Menu コントロールが MenuBar コントロールに属さない場合は、undefined です。
- target イベントをトリガしたコンポーネントへの参照です。
- type イベントの名前である menuShow です。
rollOutカーソルが Menu アイテムを離れたときにブロードキャストされます。このイベントオブジェクトには、次のプロパティが含まれます。
- menuItem 選択されたメニューアイテムです。次の形式でメニューアイテムプロパティにアクセスします。
eventobj.menuItem.attributes.attribName
- target イベントをトリガしたコンポーネントへの参照です。
- type イベントの名前である rollOut です。
rollOverカーソルが Menu アイテム上に移動するとブロードキャストされます。このイベントオブジェクトには、次のプロパティが含まれます。
- menuItem 選択されたメニューアイテムです。次の形式でメニューアイテムプロパティにアクセスします。
eventobj.menuItem.attributes.attribName

- target イベントをトリガしたコンポーネントへの参照です。
- type イベントの名前である rollOver です。

mx.core.UIComponent クラスから継承されるイベント
focusIn  focusOut  invalid  keyDown  keyUp  valid  valueCommitted 

mx.core.UIObject クラスから継承されるイベント
creationComplete  dragComplete  dragDrop  dragEnter  dragExit  dragOver  draw  effectEnd  effectStart  hide  hideToolTip  initialize  load  mouseChangeSomewhere  mouseDown  mouseDownSomewhere  mouseMove  mouseMoveSomewhere  mouseOut  mouseOver  mouseUp  mouseUpSomewhere  move  resize  show  showToolTip  unload 



スタイル
rollOverColor型 : Number   形式 : Color   CSS の継承 : あり
マウスポインタが置かれたときのリンクの背景色です。デフォルト値は 0xEFFD6 です。
selectionColor型 : Number   形式 : Color   CSS の継承 : あり
選択されたときのリンクの背景色です。デフォルト値は 0xDFFC1 です。

mx.core.UIComponent クラスから継承されるスタイル
backgroundAlpha   backgroundColor   backgroundDisabledColor   backgroundImage   backgroundSize   barColor   borderCapColor   borderColor   borderSides   borderStyle   borderThickness   cornerRadius   disabledColor   dropShadow   errorColor   fillColors   highlightColor   modalTransparency   scrollTrackColor   selectedFillColors   shadowCapColor   shadowColor   shadowDirection   shadowDistance   symbolBackgroundColor   symbolBackgroundDisabledColor   symbolBackgroundPressedColor   symbolColor   symbolDisabledColor   themeColor  

mx.core.UIObject クラスから継承されるスタイル
color   fontFamily   fontSize   fontStyle   fontWeight   horizontalGap   leading   marginLeft   marginRight   textAlign   textDecoration   textIndent   verticalGap  



メソッドの詳細

addMenu

addMenu( arg1, arg2) :  mx.controls.Menu

1 つのメニューを MenuBar コントロールの末尾に追加し、MenuBar コントロール内の新規メニューへの参照を返します。新規メニューはすぐには表示されません。

パラメータ
    arg1 - String (アイテムのラベル) か xmlNode のいずれかです。
    arg2 - undefined、メニュー、または xml/xmlNode のいずれかです。

戻り値
     新規 Menu への参照を返します。


addMenuAt

addMenuAt( index, arg1, arg2) :  Void

MenuBar コントロールの指定の位置にメニューを追加します。インデックスが 0 の場合は、MenuBar の左端の位置にメニューを挿入します。

パラメータ
    index - アイテムを挿入する必要のあるインデックスです。
    arg1 - String (アイテムのラベル) か xmlNode のいずれかです。
    arg2 - undefined、メニュー、または xml/xmlNode のいずれかです。

戻り値
     新規 Menu への参照を返します。


getMenuAt

getMenuAt( index) :  mx.controls.Menu

指定されたインデックスにあるメニューアイテムへの参照を返します。インデックス 0 が左端のメニューです。

パラメータ
    index - 取得するメニューインスタンスのインデックスです。

戻り値
    指定されたインデックス位置にあるメニューへの参照を返します。


getMenuEnabledAt

getMenuEnabledAt( index)

指定されたインデックスにあるメニューアイテムが有効にされている場合に true を返します。インデックス 0 が左端のメニューです。

パラメータ
    index - メニューインスタンスのインデックスです。

戻り値
     指定されたメニューの有効状態を示すブール値を返します。


labelFunction

labelFunction( )

各メニューアイテムに表示するテキストを判定する関数です。関数はアイテムに関連付けられた XML ノードをパラメータとして受け取り、ラベルテキストとして使用されるストリングを返します。このプロパティは、MenuBar から作成されるすべてのメニューに伝播します。


layoutChildren

layoutChildren( ) :  Void

MenuBar 上にあるアイテムのサイズと位置を設定します。


measure

measure( ) :  Void

MenuBar のデフォルトの高さと幅は 550×22 と指定されています。MenuBar のサイズを決める際に MenuBar のコンテンツは測定されません。


removeMenuAt

removeMenuAt( index) :  mx.controls.Menu

指定されたメニューを MenuBar コントロールから削除します。インデックス 0 が左端のメニューです。

パラメータ
    index - 削除するメニューインスタンスのインデックスです。

戻り値
     削除されたメニューへの参照を返します。


setMenuEnabledAt

setMenuEnabledAt( index, enable)

指定されたインデックスにあるメニューアイテムを有効または無効にします。無効にされたメニューアイテムは、クリックや表示ができません。インデックス 0 が左端のメニューです。

パラメータ
    index - 有効にするメニューインスタンスのインデックスです。
    enable - true の場合、メニューが有効にされます。



プロパティの詳細

dataProvider

dataProvider:Object  

メニューとして表示するオブジェクトの階層です。最上位の子はすべて MenuBar アイテムになり、その子はメニュー内のアイテムになります。dataProvider では TreeDataProvider インターフェイスを実装する必要があります。


labelField

labelField:String  

各メニューアイテムのテキストとして使用する dataProvider の Array 内のフィールドの名前です。省略した場合は、データプロバイダで label という名前のフィールドを設定するか、または dataProvider プロパティに String の Array を設定する必要があります。


version

static  version:String  

このクラスのバージョンを表すストリングです。


MenuBarExample.mxml
<?xml version="1.0"?>
<!-- MenuBar コントロールの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF" >

<mx:XML id="myMenuData">
<menuitem label="MenuItem A">
<menuitem label="SubMenuItem 1-A" />
<menuitem label="SubMenuItem 2-A" />
</menuitem>
</mx:XML>

<mx:Panel id="panel" title="Menu Bar Panel" height="35%" width="30%"> 
	 <mx:MenuBar id="menubar" dataProvider="{myMenuData}"/> 
</mx:Panel>

</mx:Application>