ComboBox  - AS3 Flex

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

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

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

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

関連する API エレメント

このコンポーネントが表示するアイテムのセットです。このプロパティから派生したクラスでは、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 のスタイルによってオーバーライドされます。

関連する API エレメント

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

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

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

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

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

関連する API エレメント

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 イベントが送出されます。

関連する API エレメント

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

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

デフォルト値： 5。

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