GroupingCollection2  - AS3 Flex

ソースデータに適用される Grouping インスタンスを指定します。 grouping プロパティを設定してもビューは自動的には更新されないので、このプロパティを設定した後で refresh() メソッドを呼び出す必要があります。

関連する API エレメント

グループ化するフラットデータを含むソースコレクションです。 ソースがコレクションでない場合は、自動的にコレクション内にラップされます。

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

      <mx:AdvancedDataGrid id="myADG" 
         width="100%" height="100%" 
         initialize="gc.refresh();">        
         <mx:dataProvider>
             <mx:GroupingCollection2 id="gc" source="{dpFlat}">
                 <mx:summaries>
                     <mx:SummaryRow summaryPlacement="last">
                         <mx:fields>
                             <mx:SummaryField2 dataField="Actual" 
                                 label="Min Actual" summaryOperation="MIN"/>
                             <mx:SummaryField2 dataField="Actual" 
                                 label="Max Actual" summaryOperation="MAX"/>
                         </mx:fields>
                       </mx:SummaryRow>
                     </mx:summaries>
                 <mx:Grouping>
                     <mx:GroupingField name="Region"/>
                     <mx:GroupingField name="Territory"/>
                 </mx:Grouping>
             </mx:GroupingCollection2>
         </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 エレメント

非同期更新操作に関連付けられたタイマーです。 これを使用して、タイミング間隔の変更や更新の一時停止などのアクションを実行できます。 タイマーインスタンスの delay プロパティのデフォルト値は 1 （1 ミリ秒に相当）です。

コンストラクターです。

更新が非同期的に実行される場合、更新操作をキャンセルしてグループの作成を中止します。 このメソッドは、refresh() メソッドを trueの asynch 引数（非同期更新を表す）を指定して呼び出した場合にのみ、更新をキャンセルします。

ノードの親を返します。 最上位ノードの親は null です。

パラメーター

super.source を返すのは grouping プロパティが設定されている場合です。設定されていない場合は super.source を参照する ICollectionView インスタンスを返します。

グループ化をコレクションに適用します。コレクションはグループの変更を自動検出しません。したがって、group、source または summaries プロパティを設定した後に、refresh() メソッドを呼び出して、コレクションを更新する必要があります。また、caseInsensitive、compareFunction、groupingFunction などのプロパティを変更してコレクションの GroupingField を変更したときにも、refresh() メソッドを呼び出します。

refresh() メソッドは同期的にも非同期的にも適用できます。

refresh() を同期的に呼び出した場合、メソッドが返る前に、すべてのグループと要約が一緒に更新されます。つまり、この呼び出し中は他の処理操作をアプリケーションで実行できないという意味です。クライアントは、kind プロパティの値が CollectionEventKind.REFRESH に設定された CollectionEvent イベントを待機して、refresh() メソッドが完了したことを確認する必要があります。

非同期更新では、すべてのグループと要約が個々に更新されます。グループと要約が更新される前に refresh() メソッドが返るので、アプリケーションは実行を継続できます。また、更新中にコントロールが更新されるので、ユーザーはコントロールとの対話を継続できます。

一括更新と異なり、グループと要約を個々に更新する際のオーバーヘッドがあるので、非同期更新のほうが同期更新よりも処理時間が長くなります。しかし、大規模なデータセットを扱う場合、非同期更新であれば更新中もアプリケーションを継続実行できます。

パラメーター