ソート時にアイテムを比較するために使用するメソッドです。このプロパティを指定すると、このクラスで使用する SortField オブジェクトに指定した compareFunction プロパティはすべて無視されます。

比較関数には次のシグネチャが必要です。

              function [name](a:Object, b:Object, fields:Array=null):int
           

この関数は、以下を返す必要があります。

• a が b の前に表示されるソート順の場合は -1
• a = b の場合は 0
• a が b の後に表示されるソート順の場合は 1

内部比較関数に戻すには、この値を null に設定します。

指定された fields 配列は、比較するオブジェクトフィールドを指定します。通常は、フィールドリストを使い果たすか、ゼロではない値が返されるまで、このアルゴリズムはプロパティを比較します。次に例を示します。

        function myCompare(a:Object, b:Object, fields:Array=null):int
        {
            var result:int = 0;
            var i:int = 0;
            var propList:Array = fields ? fields : internalPropList;
            var len:int = propList.length;
            var propName:String;
            while (result == 0 && (i < len))
            {
                propName = propList[i];
                result = compareValues(a[propName], b[propName]);
                i++;
            }
            return result;
        }
             function compareValues(a:Object, b:Object):int
        {
            if (a == null && b == null)
                return 0;
                 if (a == null)
              return 1;
                 if (b == null)
               return -1;
                 if (a < b)
                return -1;
                 if (a > b)
                return 1;
                 return 0;
        }
      

デフォルト値は、ストリング、数値、日付を比較できる内部比較関数です。この比較関数では、昇順または降順での比較が可能で、ストリングの比較に関しては大文字と小文字の区別の有無を指定できます。カスタム比較アルゴリズムが必要な場合にのみ、独自の関数を指定します。このことは、通常、計算フィールドが表示で使用されている場合にのみ該当します。

また、SortField クラスの compare プロパティを使用することで、各ソートフィールドに対して個別の比較関数を指定することもできます。この方法だと、一部のフィールドにはデフォルトの比較を使用して、別のフィールドには独自の比較を使用することができます。

比較するフィールドを指定する SortField オブジェクトの配列です。配列内の SortField オブジェクトの順序によって、ソート時のフィールドの優先順位が決まります。デフォルトのソートコンパレータは、比較する 2 つのフィールドのソート順が決定するまで、配列順にソートフィールドをチェックします。

デフォルト値null.

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

関連項目

ソートが一意であるかどうかを示します。フィールドプロパティのフィールドにより指定された値また組み合わせ値が不確定なソート順または一意ではないソート順になる場合、つまり複数のアイテムが同じソートフィールド値を持つ場合は、一意のソートは失敗します。

デフォルト値false.

コンストラクタ。

フィールドを設定しない、カスタムコンパレータのない新しいソートを作成します。

指定された配列内 (要求された場合は挿入ポイント) で指定されたオブジェクトを検索し、見つかった場合はインデックス、見つからなかった場合は -1 を返します。ListCollectionView クラスの findxxx() メソッドはこのメソッドを使用して、要求されたアイテムを検索します。基本的に、ListCollectionView ベースのオブジェクトからデータを検索する場合は、findItem() ではなくこれらの関数を使用するほうが簡単です。findItem() メソッドは、新しい ICollectionView 実装など、ソートをサポートするクラスを記述する場合に直接呼び出します。

指定されたプロパティを使用してソートを制御するかどうかを返します。ソートにカスタムコンパレータが使用されると、この関数は決定的な結果を判断できません。この場合は、常に true を返します。

すべての SortFields を調べて、これらのフィールドに対して reverse() を呼び出します。フィールドが降順の場合は昇順になり、昇順の場合は降順になります。

メモ : ICollectionView は、SortFields が変更されても自動的に更新されません。ビューを更新するには、refresh() メソッドを呼び出します。

指定された配列 (コピーではなく) に現在のソートを適用します。配列が変更されないようにするには、コピーを作成し、そのコピーを items パラメータで使用します。

ICollectionView 実装は、sort メソッドを自動的に呼び出し、基になるデータのコピーに対してソートが行われるようにします。

検索を実行すると、一致するアイテムのインデックスを返します。

検索を実行すると、最初に一致したアイテムのインデックスを返します。

検索を実行すると、最後に一致したアイテムのインデックスを返します。