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

mx.controls
ComboBox クラス

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

ComboBox クラス
mx.controls.ComboBase の拡張

ComboBox コントロールには、ユーザーが 1 つの値を選択できるドロップダウンリストが含まれています。HTML の SELECT フォームエレメントによく似た機能を果たします。ComboBox は編集可能にできます。この場合、List に含まれないエントリを、ユーザーが ComboBox の TextInput 部分に入力できます。

MXML シンタックス

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

 <mx:ComboBox
   dataProvider="No default."
   dropdownWidth="Size wide enough to hold text."
   editable="false|true"
   labelField="No default."
   labelFunction="No default."
   rowCount="5"
   selectedIndex="No default."
   selectedItem="No default."
   change="Event handler; no default."
   close="Event handler; no default."
   enter="Event handler; no default."
   itemRollOver="Event handler; no default."
   itemRollOut="Event handler; no default."
   open="Event handler; no default."
   scroll="Event handler; no default."
 />

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

関連項目
    List
    mx.effects.Tween
    mx.managers.PopUpManager


メソッド
       close( ) :  Void
ドロップダウンリストを非表示にします。
       layoutChildren( ) :  Void
 ドロップダウンの幅が、ComboBox の残りの幅と同じになるようにします。
       measure( ) :  Void
 コントロールのサイズを、幅は最低 100 ピクセル、高さは TextInput 領域で 1 行のテキストが入るだけ確保します。
       open( ) :  Void
ドロップダウンリストを表示します。

mx.controls.ComboBase クラスから継承されるメソッド
addItem   addItemAt   getDataProvider   getItemAt   getLength   getSelectedIndex   getSelectedIndices   getSelectedItem   getSelectedItems   layoutChildren   measure   removeAll   removeItemAt   replaceItemAt   setDataProvider   sortItems   sortItemsBy  

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
 ComboBox コントロールの dataProvider です。
       dropdown:Object   [読み取り専用]
ComboBox のドロップダウンとして機能するリストへの参照です。
       dropdownWidth:Number
ドロップダウンの幅 (ピクセル単位)。
       labelField:String
ラベルとして表示する dataProvider 配列のオブジェクト内のフィールドの名前です。
       labelFunction:Function
ラベルを決定する各アイテムで実行されるユーザー指定の関数です。
       prompt:Object
ComboBox コントロールを要求します。
       rowCount:Number
ComboBox コントロールのリストに表示される行の最大数です。
       selectedIndex:Number
 ドロップダウンリスト内で現在選択されているアイテムのインデックスです。
       selectedItem:Object
dataProvider 内の選択したアイテムへの参照を含みます。
staticversion:String
このクラスのバージョンを表すストリングです。

mx.controls.ComboBase クラスから継承されるプロパティ
dataProvider   editable   length   restrict   selectedIndex   selectedItem   text   textField   value   version  

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ユーザーの操作によって selectedIndex プロパティまたは selectedItem プロパティが変更されるとブロードキャストされます。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。このイベントオブジェクトの type プロパティには、このイベントの名前である change が含まれます。次のような、選択したアイテムの属性にアクセスできます。
evt.target.selectedItem.label
evt.target.selectedItem.data
closeユーザーがドロップダウンの項目を選択したか、ドロップダウンの外側をクリックしたか、またはドロップダウンの表示中にドロップダウンボタンをクリックして、ドロップダウンの表示を消すとブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。イベントオブジェクトの type プロパティには、イベント名 close が含まれます。
enterComboBox の editable プロパティが true に設定されている場合に、ユーザーが TextInput への入力中に Enter キーを押すとブロードキャストされます。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。このイベントオブジェクトの type プロパティには、このイベントの名前である enter が含まれます。
itemRollOutリストアイテムからマウスポインタが離れたときにブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。イベントオブジェクトの type プロパティには、イベント名 itemRollOut が含まれます。イベントオブジェクトの index プロパティには、マウスポインタが離れたアイテムのインデックスが含まれます。
itemRollOverアイテムにマウスポインタを合わせたときにブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。イベントオブジェクトの type プロパティには、イベント名 itemRollOver が含まれます。イベントオブジェクトの index プロパティには、マウスポインタを合わせたアイテムのインデックスが含まれます。
modelChangeddataProvider が変更されたときにブロードキャストします。一般的に、dataProvider への最初の要求を追加するために使用して、"Select a name..." などが最初に選択されるようにします。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。イベントオブジェクトの type プロパティには、イベント名 modelChanged が設定されます。
openユーザーがドロップダウンボタンをクリックしてドロップダウンを表示したときにブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。イベントオブジェクトの type プロパティには、イベント名 open が含まれます。
scrollユーザーが ComboBox のドロップダウンリストをスクロールしたときにブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。イベントオブジェクトの type プロパティには、イベント名 scroll が含まれます。

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 



スタイル
alternatingRowColors 型 : Array   CSS の継承 : あり
切り替えパターンで行を表示する場合に使用する色です。値には、複数の色の配列を指定します。backgroundColor が指定されていない場合にのみ使用します。
closeDuration 型 : Number   形式 : Time   CSS の継承 : なし
閉じた状態へのトランジションにかかる時間の長さ (ミリ秒単位) です。デフォルト値は 250 です。
closeEasing 型 : String   形式 : Time   CSS の継承 : なし
コンポーネントトゥイーンを制御するためのイージング関数です。
openDuration 型 : Number   形式 : Time   CSS の継承 : なし
開いた状態へのトランジションにかかる時間の長さ (ミリ秒単位) です。デフォルト値は 250 です。
openEasing 型 : String   形式 : Time   CSS の継承 : なし
コンポーネントトゥイーンを制御するためのイージング関数です。
rollOverColor 型 : Number   形式 : Color   CSS の継承 : あり
マウスポインタが置かれているときのアイテムの背景色です。デフォルト値は 0x0EFFD6 です。
selectionColor 型 : Number   形式 : Color   CSS の継承 : あり
ユーザーがアイテムを選択したときのアイテムの背景色です。デフォルト値は 0x0DFFC1 です。
selectionEasing 型 : String   CSS の継承 : なし
プログラムによるトゥイーンの制御に使用されるイージング式 (関数) への参照です。

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  



メソッドの詳細

close

close( ) :  Void

ドロップダウンリストを非表示にします。

layoutChildren

layoutChildren( ) :  Void

ドロップダウンの幅が、ComboBox の残りの幅と同じになるようにします。

measure

measure( ) :  Void

コントロールのサイズを、幅は最低 100 ピクセル、高さは TextInput 領域で 1 行のテキストが入るだけ確保します。

open

open( ) :  Void

ドロップダウンリストを表示します。



プロパティの詳細

dataProvider

dataProvider:Object  

ComboBox コントロールの dataProvider です。

dropdown

dropdown:Object   [読み取り専用]

ComboBox のドロップダウンとして機能するリストへの参照です。

dropdownWidth

dropdownWidth:Number  

ドロップダウンの幅 (ピクセル単位) です。デフォルト値は、100 または dataProvider で最も長いテキストの幅のいずれか大きいほうです。

labelField

labelField:String  

ラベルとして表示する dataProvider 配列オブジェクト内のフィールドの名前です。デフォルトでは、各配列オブジェクトの label という名前のプロパティが使用され、コントロールに表示されます。ただし、dataProvider オブジェクトに label プロパティが含まれない場合は、別のプロパティを使用するように labelField プロパティを設定できます。

labelFunction

labelFunction:Function  

ラベルを決定する各アイテムで実行されるユーザー指定の関数です。デフォルトでは、各配列オブジェクトの label という名前のプロパティを使用してラベルが決定されます。ただし、label プロパティも存在せず、ラベル表示に使用できる別のプロパティも存在しないデータセットもあります。たとえば、データセットに lastName フィールドと firstName フィールドがあり、フルネームを表示する必要がある場合が考えられます。labelFunction では、適切なフィールドを使用するコールバック関数を指定して、表示可能なストリングを返させることができます。

prompt

prompt:Object  

ComboBox コントロールを要求します。データプロバイダの先頭に追加され、"select one.." または "Western Region/EasternRegion" などのオプションを Web サービスクエリーの結果に追加できます。実際にはデータプロバイダが変更されるので、選択したインデックスが変更します。

rowCount

rowCount:Number  

ComboBox コントロールのリストに表示される行の最大数です。デフォルト値は 5 です。

selectedIndex

selectedIndex:Number  

ドロップダウンリスト内で現在選択されているアイテムのインデックスです。このプロパティを設定すると現在のインデックスが設定され、関連付けられたラベルがテキストフィールドに表示されます。デフォルト値は undefined です。コントロールが編集可能な場合、ユーザーがテキストフィールドに入力すると、selectedIndex は undefined になります。選択したインデックスが有効範囲外の場合、割り当ては無視されます。

selectedItem

selectedItem:Object  

dataProvider 内の選択したアイテムへの参照を含みます。このデータを変更すると、dataProvider とそのビューが変更されます。ComboBox コントロールが編集可能な場合、ユーザーがテキストフィールドにテキストを入力すると、selectedItem プロパティは undefined になります。このプロパティが値を持つのは、ユーザーがドロップダウンリストから項目を選択した場合と、値がプログラムによって設定された場合のみです。

version

static  version:String  

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


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

<mx:Panel title="ComboBox Panel" marginTop="10">

<mx:ComboBox id="SoftwareSelection">

<mx:dataProvider>
<mx:Array>
<mx:String>Macromedia Flex</mx:String>
<mx:String>Macromedia Dreamweaver</mx:String>
<mx:String>Macromedia ColdFusion</mx:String>
<mx:String>Macromedia Flash</mx:String>
</mx:Array>
</mx:dataProvider>

</mx:ComboBox>

</mx:Panel>

</mx:Application>