アイテムレンダラーまたはアイテムエディタで data プロパティを使用すると、コンポーネントに値を渡すことができます。通常、データバインディングを使用して、data プロパティのフィールドをこのコンポーネントのプロパティにバインドします。

ComboBox コントロールでは、listData プロパティと data プロパティを次のように使用します。ComboBox が DataGrid コントロール内にある場合、列の dataField プロパティがデータのプロパティにマッピングされ、selectedItem がそのプロパティに設定されます。ComboBox コントロールが List コントロール内にある場合、リストの labelField がデータのプロパティにマッピングされ、selectedItem がそのプロパティに設定されます。それ以外の場合は、selectedItem がデータそのものに設定されます。

MXML でこのプロパティを設定することはありません。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dataChange イベントが送出されます。

関連項目

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

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

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 collectionChange イベントが送出されます。

ComboBox のドロップダウンとして機能する List コントロールへの参照です。

ListBase から派生したインスタンスをドロップダウンリストとして使用するために生成する IFactory です。デフォルト値は、List の IFactory です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dropdownFactoryChanged イベントが送出されます。

ComboBox から dropDown に渡すスタイルのセットです。これらのスタイルは、dropDownStyleName のスタイルによってオーバーライドされます。

関連項目

ドロップダウンリストの幅をピクセル単位で表します。

デフォルト値は、100 または dataProvider で最も長いテキストの幅のいずれか大きいほうです。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dropdownWidthChanged イベントが送出されます。

コントロールのドロップダウンリストにデータを表示するインスタンスを生成する IFactory です。このプロパティを使用して、ドロップダウンリストのカスタムアイテムレンダラを指定できます。

コントロールは List コントロールを内部的に使用して、ドロップダウンリストを作成します。List コントロールのデフォルトのアイテムレンダラは、ListItemRenderer クラスであり、リスト内の各アイテムに関連付けられているテキストとオプションのアイコンを描画します。

関連項目

dataProvider 配列内のアイテムのうち、TextInput 部分とドロップダウンリストのラベルとして表示するフィールドの名前です。デフォルトでは、各配列オブジェクトの label という名前のプロパティが使用され、コントロールに表示されます。

ただし、dataProvider アイテムに label プロパティが含まれない場合は、別のプロパティを使用するように labelField プロパティを設定できます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 labelFieldChanged イベントが送出されます。

ラベルを決定するために各アイテムに対して実行されるユーザー指定の関数です。デフォルトでは、label という名前のプロパティを各 dataProvider アイテムで使用して、ラベルが決定されます。ただし、label プロパティも存在せず、ラベル表示に使用できる別のプロパティも存在しないデータセットもあります。

例えば、データセットに lastName と firstName のフィールドがあり、フルネームを表示したい場合などです。labelFunction では、適切なフィールドを使用するコールバック関数を指定して、表示可能なストリングを返すことができます。

labelFunction は単一のパラメータを取ります。このパラメータは、dataProvider 内のアイテムであり、ストリングを返します。

      myLabelFunction(item:Object):String
      

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 labelFunctionChanged イベントが送出されます。

ドロップインアイテムレンダラまたはドロップインアイテムエディタとして使用すると、このコンポーネントの listData プロパティが、List コントロールからの該当するデータで初期化されます。コンポーネントは、listData プロパティと data プロパティを使用して、ドロップインアイテムレンダラまたはドロップインアイテムエディタとして適切な情報を表示します。

MXML および ActionScript でこのプロパティを設定することはありません。このコンポーネントがドロップインアイテムレンダラまたはドロップインアイテムエディタとして使用されるときに、Flex でプロパティが設定されます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dataChange イベントが送出されます。

関連項目

ComboBox コントロールのプロンプトです。プロンプトは、selectedIndex = -1 であるときに ComboBox の TextInput 部分に表示されるストリングです。 これは通常、「Select one...」などのストリングです。 プロンプトを使用しない場合は、ComboBox コントロールにより selectedIndex が 0 に設定され、dataProvider 内の最初のアイテムが表示されます。

ComboBox コントロールのリストに表示される行の最大数です。dataProvider に存在するアイテム数がデフォルト値より少ない場合、ComboBox では dataProvider と同数のアイテムのみを表示します。

デフォルト値 : 5.

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 resize イベントが送出されます。

ドロップダウンリスト内で現在選択されているアイテムのインデックスです。このプロパティを設定すると現在のインデックスが設定され、関連付けられたラベルが TextInput 部分に表示されます。

デフォルト値は -1 ですが、dataProvider が割り当てられ、プロンプトが存在しない場合は 0 に設定されます。 コントロールが編集可能の場合、ユーザーが TextInput の部分に入力すると、selectedIndex プロパティの値は -1 になります。 selectedIndex プロパティの値が範囲外の場合、selectedIndex プロパティは dataProvider にある最後のアイテムに設定されます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 valueCommit イベントが送出されます。

dataProvider 内の選択したアイテムへの参照を含みます。 データがオブジェクトまたはクラスインスタンスの場合、そのオブジェクトまたはインスタンスのプロパティを変更すると、dataProvider とそのビューが変更されます。 アイテムが dataProvider 内に存在する場合に、selectedItem そのものを設定すると、ComboBox がそのアイテムを選択します（TextInput 部分にアイテムを表示し、selectedIndex を設定します）。

ComboBox コントロールが編集可能な場合に、ユーザーが TextInput にテキストを入力すると、selectedItem プロパティは null になります。このプロパティが値を持つのは、ユーザーがドロップダウンリストから項目を選択した場合と、値がプログラムによって設定された場合のみです。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 valueCommit イベントが送出されます。

ComboBox の TextInput 部分に表示するストリングです。 これは、labelField または labelFunction を使用してデータから計算されます。

コンストラクタです。

データプロバイダ内の最初の numItems アイテムのラベルテキストの最大サイズに基づいて、ドロップダウンリスト内の各エントリに適用するデフォルトの高さと幅を決定します。

パラメータ

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

パラメータ

item パラメータを表すストリングを返します。

このメソッドは、次の順序で確認して、返す値を見つけます。

1. labelFunction プロパティが指定されている場合、アイテムを関数に渡した結果を返します。
2. アイテムがストリング、数値、ブール値または関数の場合、そのアイテムを返します。
3. コントロールの labelField プロパティで指定された名前のプロパティをアイテムが持つ場合、そのプロパティの内容を返します。
4. アイテムにラベルプロパティがある場合、その値を返します。

パラメータ

コントロールの幅が最低でも 40 ピクセルあり、コントロールの TextInput 部分に 1 行のテキストが入るだけの高さがある（ただし最低でも 22 ピクセル必要です）ことを確認します。

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

送出されるのは、ユーザー操作の結果として ComboBox の内容が変化したとき、selectedIndex プロパティまたは selectedItem プロパティが変更されたとき、および ComboBox コントロールが編集可能な状態で、キーストロークがボックスに入力されたときです。

イベントオブジェクトの各プロパティには次の値が設定されています。

次に示すユーザーの操作によってドロップダウンリストが消えたときに送出されます。

• ドロップダウンリストのアイテムを選択する
• ドロップダウンリストの外側をクリックする
• ドロップダウンリストが表示されているときにドロップダウンボタンをクリックする
• ドロップダウンリストが表示されているときに ESC キーを押す

イベントオブジェクトの各プロパティには次の値が設定されています。

data プロパティが変更されたときに送出されます。

コンポーネントをアイテムレンダラとして使用すると、data プロパティには dataProvider のアイテムが含まれます。このイベントを受け取って、data プロパティが変更されたときにコンポーネントを更新することができます。

イベントオブジェクトの各プロパティには次の値が設定されています。

editable プロパティが true に設定されている場合に、ユーザーが編集可能なテキストフィールドへの入力中に Enter キーを押すと送出されます。

イベントオブジェクトの各プロパティには次の値が設定されています。

ユーザーがドロップダウンリストアイテムの外側にマウスを移動したときに送出されます。イベントオブジェクトの target プロパティには、ドロップダウンリストではなく ComboBox への参照が含まれます。

イベントオブジェクトの各プロパティには次の値が設定されています。

ユーザーがドロップダウンリストアイテムの上にマウスを移動したときに送出されます。イベントオブジェクトの target プロパティには、ドロップダウンリストではなく ComboBox への参照が含まれます。

イベントオブジェクトの各プロパティには次の値が設定されています。

ユーザーがドロップダウンボタンをクリックしてドロップダウンリストを表示したときに送出されます。これは、ユーザーがキーボードで Ctrl キーを押しながら下矢印キーを押してドロップダウンを開いた場合にも送出されます。

イベントオブジェクトの各プロパティには次の値が設定されています。

ユーザーが ComboBox コントロールのドロップダウンリストをスクロールしたときに送出されます。

イベントオブジェクトの各プロパティには次の値が設定されています。