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

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

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

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

関連項目

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

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

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

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

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

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

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

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

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

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

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

関連項目

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

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

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

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

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

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

      myLabelFunction(item:Object):String
      

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

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

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

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

関連項目

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

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

デフォルト値5.

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

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

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

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

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

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

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

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

コンストラクタです。

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

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

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

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

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

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

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

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

The ListEvent.CHANGE 定数は change イベントの ListEvent オブジェクトの type プロパティ値を定義し、ユーザー操作の結果として選択が変更されたことを示します。

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

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

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

DropdownEvent.CLOSE 定数により、close イベントのイベントオブジェクトの type プロパティ値が定義されます。

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

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

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

FlexEvent.DATA_CHANGE 定数により、dataChange イベントのイベントオブジェクトの type プロパティ値が定義されます。

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

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

FlexEvent.ENTER 定数により、enter イベントのイベントオブジェクトの type プロパティ値が定義されます。

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

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

ListEvent.ITEM_ROLL_OUT 定数は、itemRollOut イベントの ListEvent オブジェクトの type プロパティ値を定義します。このイベントは、ユーザーがマウスポインタをコントロール内の視覚的なアイテムの外側に移動したことを示します。

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

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

ListEvent.ITEM_ROLL_OVER 定数は、itemRollOver イベントの ListEvent オブジェクトの type プロパティ値を定義します。このイベントは、ユーザーがコントロール内の視覚的なアイテムに、マウスポインタを合わせたことを示します。

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

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

DropdownEvent.OPEN 定数により、open イベントのイベントオブジェクトの type プロパティ値が定義されます。

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

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

ScrollEvent.SCROLL 定数は、scroll イベントのイベントオブジェクトの type プロパティ値を定義します。

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