<mx:tagname Properties allowDragSelection="false|true" allowMultipleSelection="false|true" columnCount="4" columnWidth="NaN" dataProvider="null" dataTipField="label" dataTipFunction="null" dragEnabled="false|true" dragMoveEnabled="false|true" dropEnabled="false|true" iconField="null" iconFunction="null" itemRenderer="null" labelField="label" labelFunction="null" lockedColumnCount=0 lockedRowCount=0 menuSelectionMode="false|true" rowCount="-1" rowHeight="NaN" selectable="true|false" selectedIndex="-1" selectedIndices="null" selectedItem="null" selectedItems="null" showDataTips="false|true" variableRowHeight="false|true" wordWrap="false|true" Styles alternatingItemColors="undefined" dataChangeEffect="undefined" dropIndicatorSkin="ListDropIndicator" focusAlpha="0.5" focusRoundedCorners="tl tr bl br" paddingBottom="2" paddingLeft="2" paddingRight="0" paddingTop="2" rollOverColor="0xEEFEE6" selectionColor="0x7FCEFF" selectionDisabledColor="0xDDDDDD" selectionDuration="250" selectionEasingFunction="undefined" textRollOverColor="0x2B333C" textSelectedColor="0x2B333C" useRollOver="true|false" verticalAlign="top|middle|bottom" Events change="No default" dataChange="No default" itemClick="No default" itemDoubleClick="No default" itemRollOut="No default" itemRollOver="No default" itemClick="No default" />]]>
モデルとビューのアーキテクチャでは、AdvancedListBase サブクラスはビューを表し、データプロバイダーはモデルを表します。
コンポーネントをアイテムレンダラーとして使う場合、
このメソッドは、ドラッグ & ドロップによるコピー作成で使用されます。
ListBase またはその子のサブクラスを作成する開発者が使用します。 アプリケーション開発者が使用することはありません。
例えば、次のデータプロバイダーは無効です。これは、値 "foo" が 2 回出現しており、ストリングの UID がストリング自体であるためです。
var sampleDP:Array = ["foo", "bar", "foo"]
単純な動的オブジェクトの場合、2 つの別々のインスタンスであれば 2 回出現してかまいません。次の例は、それぞれのインスタンスが異なるオブジェクトであり、異なる UID が与えられているので有効です。
var sampleDP:Array = [{label: "foo"}, {label: "foo"}]
次の例は同じインスタンスが 2 回出現しているため無効です。
var foo:Object = {label: "foo"}; sampleDP:Array = [foo, foo];
このメソッドは AdvancedListBase クラスでは実装されないため、子クラスで実装する必要があります。
負の
このメソッドは AdvancedListBase クラスでは実装されないため、子クラスで実装する必要があります。
負の
リストクラスでも、
AdvancedListBase の場合、デフォルトのリストが単一列であり、水平方向にスクロールされることはないので、AdvancedListBase では実装されていません。
リストクラスでは、スクロール位置の変化幅が表示されている行の数より少なかった場合にスクロールの最適化を試みます。 変更は行わず、移動だけが必要な行がある場合は、他の行が削除され、新しい行が追加されます。 スクロール位置の変化が大きすぎる場合は、古い行がすべて削除され、可視領域全体に対して
AdvancedListBase の場合、デフォルトのリストが単一列であり、水平方向にスクロールされることはないので、AdvancedListBase では実装されていません。
リストクラスでは、スクロール位置の変化幅が表示されている行の数より少なかった場合にスクロールの最適化を試みます。 変更は行わず、移動だけが必要な行がある場合は、他の行が削除され、新しい行が追加されます。 スクロール位置の変化が大きすぎる場合は、古い行がすべて削除され、可視領域全体に対して
アンカーが存在し、Shift キーを使用した状態で別のアイテムを選択した場合、以前に選択されていたアイテムのセットがクリアされ、アイテムとアンカーの間にあるすべてのアイテムが選択されます。Ctrl キーを使用した状態でアイテムをクリックすると、個々のアイテムの選択が切り替わります。アンカーは移動しません。
キーボードを使用してアイテムを選択する場合、修飾キーを使用せずに矢印キーを使用すると、以前の選択がクリアされ、新しいアイテムが選択されてアンカーおよびキャレットになり、キャレットのインジケーターが選択ハイライトの周囲に表示されます。
ユーザーが Shift キーと共に矢印キーを使用した場合、以前の選択がクリアされ、アンカーと新しいアイテムの間にあるアイテムが選択されます。 キャレットは新しいアイテムに移動します。
Ctrl キーと共に矢印キーを使用した場合は、キャレットが移動するだけです。 ユーザーは、スペースキーを使用してキャレットの位置にあるアイテムの選択を切り替えることができます。
このプロパティの妥当な値は、画面上に表示される行の概数です。 このプロパティを非常に大きな値に設定すると、多数のアイテムを含む dataProvider で使用するときに、パフォーマンスの問題が発生することがあります。
メモ:このプロパティを設定しても、DataGrid コントロールには影響はありません。このコントロールの列数は、コントロールの幅と個々の列幅に基づきます。
変換の結果、
dataTipFunction は、次のようにデータプロバイダー内のアイテムである引数を 1 つ受け取り、String を返します。
myDataTipFunction(item:Object):String
リストクラスでは、
このプロパティはデータプロバイダーを使用しますが、データプロバイダーの設定は行いません。 どのような場合でも、何らかの方法でデータプロバイダーを設定する必要があります。
MXML でこのプロパティを設定することはありません。
このプロパティを
レンダラーは、iconField として指定された名前のプロパティをデータプロバイダーオブジェクトで探します。 このプロパティの値が Class の場合、そのクラスをインスタンス化し、IFlexDisplayObject のインスタンスと想定します。 このプロパティの値が String の場合は、その名前を持つ Class がアプリケーションに存在するかどうかを確認します。該当する Class が見つからない場合には、その名前を持つプロパティをドキュメントで検索し、該当のプロパティが Class にマッピングされていると想定します。
iconFunction(item:Object):Class
デフォルトのアイテムレンダラーは、コンポーネントクラスによって異なります。 例えば、AdvancedDataGrid クラスでは AdvancedDataGridItemRenderer を使用します。
このような場合に、適切なフィールドを検索して表示可能なストリングを返す
ほとんどのコンポーネントでは、ラベル関数はデータプロバイダー内のアイテムである引数を 1 つ受け取り、String を返します。
myLabelFunction(item:Object):String
データグリッドクラスのメソッドシグネチャは次のとおりです。
myLabelFunction(item:Object, column:DataGridColumn):String
ここで、
MXML および ActionScript でこのプロパティを設定することはありません。このコンポーネントがドロップインアイテムレンダラーまたはドロップインアイテムエディターとして使用されるときに、Flex でプロパティが設定されます。
データグリッドコントロールの場合、
デフォルト値は -1 です(アイテムは選択されていません)。
メモ: 多くの場合、