borderMetrics:EdgeMetrics  [read-only]

4 つのプロパティを持つ EdgeMetrics オブジェクトを返します。このプロパティとは、left、top、right、および bottom です。各プロパティの値は、それに対応する側の境界の太さをピクセル単位で表した数値に等しくなります。

実装
    protected function get borderMetrics():EdgeMetrics

protected var collection:ICollectionView

このコンポーネントが表示するアイテムの ICollectionView です。

dataProvider:Object  [read-write]

このコンポーネントが表示するアイテムのセットです。このプロパティは Object 型です。派生したクラスでは、Arrays、XML、ICollectionViews、その他のクラスなどのさまざまなデータ型を処理できます。このプロパティの値を取得した場合は、すべてが ICollectionView に変換され、その ICollectionView が返されます。設定した値が ICollectionView ではなかった場合、値は取得されません。

このプロパティを設定すると、selectedIndex プロパティが調整され、selectedItem プロパティも調整されます。ただし、selectedIndex プロパティが別途設定されている場合は除きます。prompt プロパティが存在しない場合、selectedIndex プロパティは 0 に設定されます。それ以外の場合は、-1 のままになります。-1 は、プロンプトストリングに使用されるインデックスです。selectedIndex プロパティが既に設定されており、新しいデータプロバイダの範囲を超えている場合は、予想外の動作が発生する可能性があります。

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

実装
    public function get dataProvider():Object
    public function set dataProvider(value:Object):void

editable:Boolean  [read-write]

コントロールが編集可能であるかどうかを示すフラグです。編集可能な場合は、dataProvider に指定されていないエントリをユーザーが直接入力できます。編集できない場合は、dataProvider 内のアイテムから選択する必要があります。

true の場合、キーボード入力は編集可能なテキストフィールドに入力されます。それ以外の場合は、dataProvider のアイテムを選択するためのショートカットとして使用されます。

デフォルト値false. This property is ignored by the DateField control..

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

実装
    public function get editable():Boolean
    public function set editable(value:Boolean):void

imeMode:String  [read-write]

IME (入力メソッドエディタ) のモードを指定します。IME を使用することによって、ユーザーは中国語、日本語、および韓国語のテキストを入力できます。Flex では、コントロールにフォーカスが置かれたときに、IME を指定されたモードに設定し、コントロールからフォーカスが離れたときに、元のモードに戻します。

flash.system.IMEConversionMode クラスで、このプロパティの有効な値の定数を定義します。IME をまったく指定しない場合は、null を指定します。

デフォルト値null.

実装
    public function get imeMode():String
    public function set imeMode(value:String):void

protected var iterator:IViewCursor

dataProvider からアイテムを取得し、レンダラーにアイテムを渡すために使用されるメイン IViewCursor です。メイン IViewCursor は、コードシーケンスの終わりにおいて、画面の一番上に表示されるアイテムに常に配置される必要があります。

restrict:String  [read-write]

ユーザーがテキストフィールドに入力できる文字、または入力できない文字のセットです。

デフォルト値null.

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

実装
    public function get restrict():String
    public function set restrict(value:String):void

関連項目

selectedIndex:int  [read-write]

選択されたアイテムのデータプロバイダ内のインデックスです。prompt がある場合、selectedIndex の値を -1 に設定してプロンプトを表示できます。prompt プロパティがない場合、selectedIndex は、dataProvider が設定された後で 0 に設定されます。

ComboBox コントロールが編集可能な場合は、ユーザーがテキストフィールドにテキストを入力すると、selectedIndex プロパティは -1 になります。

設定後にただちに有効になるわけではない他の多くの Flex プロパティとは異なり、selectedIndex プロパティと selectedItem プロパティは同期しているので、片方のプロパティを設定すると、もう一方のプロパティにただちに影響を与えます。

デフォルト値-1.

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

実装
    public function get selectedIndex():int
    public function set selectedIndex(value:int):void

selectedItem:Object  [read-write]

selectedIndex の位置にあるデータプロバイダ内のアイテムです。

データがオブジェクトまたはクラスインスタンスの場合、オブジェクトまたはインスタンスの変更プロパティは dataProvider オブジェクトを変更しますが、インスタンスが Bindable でない、IPropertyChangeNotifier を実装しない、または dataProvider.itemUpdated() への呼び出しが発生しなければ、ビューは更新されない可能性があります。

アイテムがデータプロバイダに存在する場合に、selectedItem プロパティを設定すると、ComboBox コントロールでそのアイテムが選択されます。つまり、テキストフィールドにそのアイテムが表示され、selectedIndex が設定されます。ComboBox コントロールが編集可能な場合に、ユーザーがテキストフィールドにテキストを入力すると、selectedItem プロパティは null になります。

設定後にただちに有効になるわけではない他の多くの Flex プロパティとは異なり、selectedIndex と selectedItem は同期しているので、片方のプロパティを設定すると、もう一方のプロパティにただちに影響を与えます。

デフォルト値null;.

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

実装
    public function get selectedItem():Object
    public function set selectedItem(value:Object):void

text:String  [read-write]

テキストフィールドの内容です。コントロールが編集可能でない場合、このプロパティの設定は無効です。コントロールが編集不可能な場合、このプロパティを設定すると、テキストフィールドの内容が設定されます。

デフォルト値"".

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

実装
    public function get text():String
    public function set text(value:String):void

protected var textInput:TextInput

現在の選択範囲を表示する内部 TextInput サブコンポーネントです。

value:Object  [read-only]

選択されたアイテムの値です。アイテムが数値またはストリングの場合は、値とアイテムは同じです。アイテムがオブジェクトの場合、その値は、data プロパティ (存在する場合) または label のプロパティ (存在する場合) です。

メモ:通常は、このプロパティではなく、selectedItem プロパティの使用をお勧めします。value プロパティは、古いアプリケーションとの後方互換性を維持するためのものです。

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

実装
    public function get value():Object

public 関数 ComboBase()

コンストラクタ。

protected function calculatePreferredSizeFromData(numItems:int):Object

ドロップダウンリストのエントリで使用する高さと幅のデフォルト値を決定します。ComboBase の各サブクラスはこのメソッドを実装し、次の 2 つのプロパティを含む Object を返す必要があります。width および height です。

パラメータ

numItems:int — サイズを決定するためにチェックするアイテムの数です。

戻り値

Object — width プロパティと height プロパティを持つ Object です。

protected function collectionChangeHandler(event:Event):void

データプロバイダに対する変更に応答します。コンポーネントの選択されたアイテムの前にアイテムが追加または削除された場合、コンポーネントは selectedIndex プロパティを調整します。

パラメータ

event:Event — コレクションから送出される CollectionEvent

関連項目

protected function downArrowButton_buttonDownHandler(event:FlexEvent):void

ドロップダウンボタンが押されたときに、何らかのアクションを実行します。これは抽象基本クラスの実装なので何も実行されず、サブクラスによってオーバーライドされます。

パラメータ

event:FlexEvent

protected function itemToUID(data:Object):String

dataProvider アイテムの UID を決定します。すべての dataProvider アイテムに、一意の識別子 (UID) を割り当てる必要があります。

パラメータ

data:Object — dataProvider アイテム

戻り値

String — 一意の識別子です。

protected override function measure():void

コントロールの measuredWidth プロパティと measuredHeight プロパティを求めます。得られる幅は、dataProvider のテキストの最大幅とドロップダウンボタンの幅を合計した数値です。得られる高さは、ボタンとテキストのいずれか高いほうの値になります。データプロバイダが設定されていない場合、またはデータプロバイダにアイテムが存在しない場合、measuredWidth プロパティは UIComponent.DEFAULT_MEASURED_WIDTH に設定され、measuredHeight プロパティは UIComponent.DEFAULT_MEASURED_HEIGHT に設定されます

関連項目

protected function textInput_changeHandler(event:Event):void

コンポーネントの編集可能テキストフィールドとして機能する TextInput の変更を処理します。このメソッドは、selectedIndex を -1 に設定します (したがって、selectedItem は null に設定されます)。

パラメータ

event:Event

protected override function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void

内部コンポーネントを指定された幅と高さで配置します。ドロップダウンボタンは右端に配置され、テキストフィールドは残された領域に配置されます。

パラメータ

	unscaledWidth:Number — コンポーネントの scaleX プロパティの値にかかわらず、コンポーネントの座標内でピクセル単位によりコンポーネントの幅を指定します。
	unscaledHeight:Number — コンポーネントの scaleY プロパティの値にかかわらず、コンポーネントの座標内でピクセル単位でコンポーネントの高さを指定します。

関連項目