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

mx.controls
ComboBase クラス

継承を示す線継承を示す線
直接の既知のサブクラス
           mx.controls.ComboBoxmx.controls.DateField

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

ComboBase は、テキストを表示する他、表示するテキストをユーザーが選択できるドロップダウンを表示させるボタンを含む、ComboBox、DateField、および他のコントロールの基本クラスです。

MXML シンタックス

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

 <mx:tagname
dataProvider="No default.
editable="false|true"
length="No default.
restrict="No default."
selectedIndex="No default."
selectedItem="No default."
text="No default."
textField="No default."
value="No default."
/>

関連項目
    SimpleButton
    TextInput
    listclasses.DataProvider
    listclasses.DataSelector



メソッド
       addItem( label, data) :  Void
dataProvider 配列の末尾にアイテムを追加します。
       addItemAt( index:Number, label, data) :  Void
dataProvider 内の指定された場所にアイテムを追加します。
       getDataProvider( ) :  Object
使用されているデータプロバイダを取得します。
       getItemAt( index:Number) :  Object
現在のソート順と dataProvider の内容に基づいて、dataProvider 内の指定された場所のアイテムを取得します。
       getLength( ) :  Number
dataProvider 内のアイテムの数です。
       getSelectedIndex( ) :  Number
選択されたアイテムのインデックスを取得します。
       getSelectedIndices( ) :  Array
選択されたアイテムのインデックスをエレメントとする配列を取得します。
       getSelectedItem( ) :  Object
選択されたアイテムを取得します。
       getSelectedItems( ) :  Array
選択されたアイテムをエレメントとする配列を取得します。
       layoutChildren( ) :  Void
右側にドロップダウンのボタンを配置して、残りの領域が埋まるようテキストのサイズを調整します。
       measure( ) :  Void
推奨される幅は、テキストの幅とドロップダウンボタンの幅を合わせたものです。
       removeAll( ) :  Void
すべてのアイテムを削除します。
       removeItemAt( index:Number) :  Object
指定された場所のアイテムを削除します。
       replaceItemAt( index:Number, newLabel, newData) :  Void
指定された場所のアイテムを置き換えます。
       setDataProvider( dP:Object) :  Void
使用するデータプロバイダを設定します。
       sortItems( compareFunc, order) :  Void
リストをソートします。
       sortItemsBy( fieldName, order) :  Void
指定したフィールドでリストをソートします。

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
表示するデータのセットです。
       editable:Boolean
true の場合、コントロールは編集可能であり、ドロップダウンで指定されていない項目をユーザーが直接入力できます。
       length:Number   [読み取り専用]
dataProvider 内のアイテムの数です。
       restrict:String
ユーザーがテキストフィールドに入力できる文字、または入力できない文字のセットです。
       selectedIndex:Number
dataProvider 内の選択したアイテムのインデックスです。
       selectedItem:var
dataProvider 内の選択したアイテムへの参照です。
       text:String
テキストコンポーネントの内容です。
       textField:var    [読み取り専用]
TextInput コンポーネントへの参照です。
       value:Object
選択されているアイテムにデータプロパティがあれば、そのデータプロパティを表します。ない場合は、そのアイテムのラベルプロパティを表します。
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  



イベント

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 



スタイル

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  



メソッドの詳細

addItem

addItem( label, data) :  Void

dataProvider 配列の末尾にアイテムを追加します。このビューも dataProvider の他のビューも、ただちに更新されます。

メソッドシグネチャは addItem(label:String, data) です。

パラメータ
    label - 新規アイテムのラベルです。
    data - 新規アイテムのデータです。Number、String、Object、Array などを指定できます。

戻り値
     追加されたアイテムです。


addItemAt

addItemAt( index:Number, label, data) :  Void

dataProvider 内の指定された場所にアイテムを追加します。このビューも dataProvider の他のビューも、ただちに更新されます。

メソッドシグネチャは addItemAt(index:Number, label:String, data) です。

パラメータ
    index:Number - アイテムが追加されるインデックスです。
    label - 新規アイテムのラベルです。
    data - 新規アイテムのデータです。Number、String、Object、Array などを指定できます。

戻り値
     追加されたアイテムです。


getDataProvider

getDataProvider( ) :  Object

使用されているデータプロバイダを取得します。メソッドシグネチャは getDataProvider() です。

戻り値
     DataProvider


getItemAt

getItemAt( index:Number) :  Object

現在のソート順と dataProvider の内容に基づいて、dataProvider 内の指定された場所のアイテムを取得します。メソッドシグネチャは getItemAt(index:Number) です。

パラメータ
    index:Number - 返されるアイテムのインデックスです。

戻り値
     アイテムです。


getLength

getLength( ) :  Number

dataProvider 内のアイテムの数です。これは、必ずしも表示されるアイテムの数ではありません。

戻り値
     Number


getSelectedIndex

getSelectedIndex( ) :  Number

選択されたアイテムのインデックスを取得します。

戻り値
     選択されたアイテムのインデックスです。


getSelectedIndices

getSelectedIndices( ) :  Array

選択されたアイテムのインデックスをエレメントとする配列を取得します。DataSelector で複数選択が許可されている場合にのみ役立ちます。

戻り値
     選択されたアイテムのインデックスをエレメントとする配列です。


getSelectedItem

getSelectedItem( ) :  Object

選択されたアイテムを取得します。

戻り値
     選択されたアイテムです。


getSelectedItems

getSelectedItems( ) :  Array

選択されたアイテムをエレメントとする配列を取得します。DataSelector で複数選択が許可されている場合にのみ役立ちます。

戻り値
     選択されたアイテムをエレメントとする配列です。


layoutChildren

layoutChildren( ) :  Void

右側にドロップダウンのボタンを配置して、残りの領域が埋まるようテキストのサイズを調整します。


measure

measure( ) :  Void

推奨される幅は、テキストの幅とドロップダウンボタンの幅を合わせたものです。高さは、ボタンとテキストのいずれか高いほうの値になります。


removeAll

removeAll( ) :  Void

すべてのアイテムを削除します。このビューも dataProvider の他のビューも、ただちに更新されます。

メソッドシグネチャは removeAll() です。


removeItemAt

removeItemAt( index:Number) :  Object

指定された場所のアイテムを削除します。このビューも dataProvider の他のビューも、ただちに更新されます。

メソッドシグネチャは removeItemAt(index:Number) です。

パラメータ
    index:Number - 削除されるアイテムのインデックスです。

戻り値
     削除されるアイテムです。


replaceItemAt

replaceItemAt( index:Number, newLabel, newData) :  Void

指定された場所のアイテムを置き換えます。このビューも dataProvider の他のビューも、ただちに更新されます。

メソッドシグネチャは replaceItemAt(index:Number, label:String, data) です。

パラメータ
    index:Number - 置き換えられるアイテムのインデックスです。
    newLabel: String - 新規アイテムのラベルを指定します。
    newData: Object - 新規アイテムのデータを指定します。


setDataProvider

setDataProvider( dP:Object) :  Void

使用するデータプロバイダを設定します。メソッドシグネチャは setDataProvider(dp :Object) です。

パラメータ
    dP:Object - データプロバイダを指定します。


sortItems

sortItems( compareFunc, order) :  Void

リストをソートします。compareFunc は 3 つのパラメータを取ります。1 つ目のパラメータを 2 つ目のパラメータの前にソートする必要がある場合は、-1 を返します。2 つのパラメータが同等である場合は、0 を返します。1 つ目のパラメータを 2 つ目のパラメータの後にソートする必要がある場合は、+1 を返します。3 つ目のパラメータは、ソート方向、大文字と小文字の区別などを示す、Array クラスからのフラグのビットマスクです。このビューおよび dataProvider の他のビューは、直ちに更新されます。

メソッドシグネチャは sortItems(compareFunc:Function, flags:Number) です。

パラメータ
    compareFunc - 比較に使用する機能です。
    order - 昇順の場合は "asc"、降順の場合は "desc" です。


sortItemsBy

sortItemsBy( fieldName, order) :  Void

指定したフィールドでリストをソートします。このメソッドは、データがストリングであるか数値であるかを判別し、それに従ってソートを試みます。他の (日付と時刻などの) ソートは、sortItems() メソッドを使用して行う必要があります。このビューも dataProvider の他のビューも、ただちに更新されます。

メソッドシグネチャは sortItemsBy(fieldName:String, order:String) です。

パラメータ
    fieldName - ソートするフィールドです。
    order - 昇順の場合は "asc"、降順の場合は "desc" です。



プロパティの詳細

dataProvider

dataProvider:Object  

表示するデータのセットです。一部のクラスは、単純な配列を使用します。XML 階層を使用するものもあります。また、クラスインスタンスを使用するものもあります。一般的に、dataProvider の構成を推測で判断することは避けてください。


editable

editable:Boolean  

true の場合、コントロールは編集可能であり、ドロップダウンで指定されていない項目をユーザーが直接入力できます。デフォルト値は false です。このプロパティは DateField コントロールからは無視されます。


length

length:Number   [読み取り専用]

dataProvider 内のアイテムの数です。これは、必ずしも表示されるアイテムの数ではありません。


restrict

restrict:String  

ユーザーがテキストフィールドに入力できる文字、または入力できない文字のセットです。TextField.restrict に関する説明を参照してください。


selectedIndex

selectedIndex:Number  

dataProvider 内の選択したアイテムのインデックス。このプロパティを設定すると、他のすべてのアイテムの選択状態がクリアされます。


selectedItem

selectedItem:var  

dataProvider 内の選択したアイテムへの参照です。このデータを変更すると、dataProvider とそのビューが変更されます。


テキスト

text:String  

テキストコンポーネントの内容です。編集可能な場合は、テキストコンポーネントの内容の設定も行います。


textField

textField:var   [読み取り専用]

TextInput コンポーネントへの参照です。


value

value:Object  

選択されているアイテムにデータプロパティがあれば、そのデータプロパティを表します。ない場合は、そのアイテムのラベルプロパティを表します。


version

static  version:String  

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