GroupingField  - AS3 Flex

このフィールドのソートで大文字と小文字を区別しない場合、true に設定します。

デフォルト値： false。

関連付けられたコレクションのアイテムをソートするときに 2 つのアイテムを比較する関数です。 Grouping オブジェクトの compareFunction プロパティを指定した場合、GroupingField オブジェクトの compareFunction プロパティはすべて無視されます。

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

function myCompare(a:Object, b:Object):int

この関数では、次の値が返される必要があります。

• a が b の前に現れるソート順の場合は -1 です。
• a が b と等しい場合は 0 です。
• a が b の後に表示されるソート順の場合は 1 です。

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

このフィールドのソートが降順の場合、true に設定します。

デフォルト値： false。

このグループのラベルを決定する関数です。 デフォルトでは、グループは、name プロパティが指定したフィールドと一致するデータ内のフィールドテキストを表示します。 しかし場合によっては、データ内の複数のフィールドに基づいてアイテムをグループ化したり、単純なストリングフィールドではないものに基づいてグループ化したりしたいこともあります。 そのような場合は、groupingFunction プロパティを使用して、コールバック関数を指定します。

コールバック関数では、月の数字を月のストリングに変換したり、フィールドの実際の値以外の条件に基づいて複数のアイテムを単純なグループにまとめたりできます。

GroupField の場合、メソッドシグネチャの形式は次のようになります。

groupingFunction(item:Object, field:GroupField):String

ここで、item はデータアイテムオブジェクトを示し、field は GroupField オブジェクトを示します。

      private function groupFunc(item:Object, field:GroupingField):String
      {
          return item[field.name].toString().substr(0, 1);
      }
      

グループ化オブジェクトを決定するために、各グループノードで実行されるコールバック関数です。 デフォルトでは、新しいオブジェクトはグループノード用に作成されます。

グループノードに適切なオブジェクトを提供する groupingObjectFunction を指定できます。

メソッドシグネチャは次のとおりです。

      myGroupObjectFunction(label:String):Object

ここで、label には、そのグループノードについて表示される値が含まれます。 関数は、グループノードに使用されるオブジェクトを返します。

      private function groupObjFunction(label:String):Object
      {
          var obj:Object = {};
          obj.name = "Bob";
     
          return obj;
      }
      

ソートするフィールドの名前です。

デフォルト値： null。

ソート対象のフィールドに数値（Number/int/uint）または数値を表すストリングが含まれている場合、コンパレータが数値比較を使用するように指定します。 このプロパティが false の場合、数値のストリング表現が含まれるフィールドは、ストリング比較を使用してソートされます。例えば、"1" は "9" よりも小さいストリング値なので、100 は 99 より先に来ます。

デフォルト値： false。

グループレベルの要約を定義する SummaryRow インスタンスの配列です。 1 つまたは複数の SummaryRow インスタンスを指定してデータ要約を定義します。次に例を示します。

      <mx:AdvancedDataGrid id="myADG" 
         width="100%" height="100%" 
         initialize="gc.refresh();">        
         <mx:dataProvider>
             <mx:GroupingCollection id="gc" source="{dpFlat}">
                 <mx:Grouping>
                     <mx:GroupingField name="Region">
                       <mx:summaries>
                           <mx:SummaryRow summaryPlacement="group">
                             <mx:fields>
                                 <mx:SummaryField dataField="Actual" 
                                     label="Min Actual" operation="MIN"/>
                                 <mx:SummaryField dataField="Actual" 
                                     label="Max Actual" operation="MAX"/>
                             </mx:fields>
                           </mx:SummaryRow>
                         </mx:summaries>
                     </mx:GroupingField>
                 </mx:Grouping>
             </mx:GroupingCollection>
         </mx:dataProvider>        
         
         <mx:columns>
             <mx:AdvancedDataGridColumn dataField="Region"/>
             <mx:AdvancedDataGridColumn dataField="Territory_Rep"
                 headerText="Territory Rep"/>
             <mx:AdvancedDataGridColumn dataField="Actual"/>
             <mx:AdvancedDataGridColumn dataField="Estimate"/>
             <mx:AdvancedDataGridColumn dataField="Min Actual"/>
             <mx:AdvancedDataGridColumn dataField="Max Actual"/>
         </mx:columns>
      </mx:AdvancedDataGrid>  
      

関連する API エレメント

コンストラクターです。