（Flex データ視覚化コンポーネントのみ）
パッケージmx.collections
クラスpublic class GroupingCollection
継承GroupingCollection Inheritance HierarchicalData Inheritance EventDispatcher Inheritance Object
実装 IGroupingCollection

GroupingCollection クラスを使用すると、AdvancedDataGrid コントロールに表示するために、フラットデータからグループデータを作成できます。 フラットデータから GroupingCollection のインスタンスを作成する場合は、階層の作成に使用するデータのフィールドを 1 つ以上指定します。

グループ化されたデータを AdvancedDataGrid コントロールに格納するには、フラットデータから GroupingCollection クラスのインスタンスを作成し、その GroupingCollection インスタンスを AdvancedDataGrid コントロールのデータプロバイダに渡します。 フラットデータのグループ化フィールドを指定するには、Grouping インスタンスを GroupingCollection.grouping プロパティに渡します。 Grouping インスタンスには、GroupingField インスタンスの配列が含まれます。配列内の GroupingField インスタンスはグループ化フィールドごとに 1 つずつ存在します。

次の例では、GroupingCollection クラスを使用して Region と Territory という 2 つのグループ化フィールドを定義しています。

  <mx:AdvancedDataGrid id="myADG"    
    <mx:dataProvider> 
      <mx:GroupingCollection id="gc" source="{dpFlat}"> 
        <mx:grouping> 
          <mx:Grouping> 
            <mx:GroupingField name="Region"/> 
            <mx:GroupingField name="Territory"/> 
          </mx:Grouping> 
        </mx:grouping> 
      </mx:GroupingCollection> 
    </mx:dataProvider>  
     
    <mx:columns> 
      <mx:AdvancedDataGridColumn dataField="Region"/> 
      <mx:AdvancedDataGridColumn dataField="Territory"/> 
      <mx:AdvancedDataGridColumn dataField="Territory_Rep"/> 
      <mx:AdvancedDataGridColumn dataField="Actual"/> 
      <mx:AdvancedDataGridColumn dataField="Estimate"/> 
    </mx:columns> 
  </mx:AdvancedDataGrid>

MXML のシンタックスexpandedMXML シンタックスを隠す
The <mx.GroupingCollection> inherits all the tag attributes of its superclass, and defines the following tag attributes:

  <mx:GroupingCollection
  Properties 
    grouping="No default"
    source="No default"
    summaries="No default"
  />

デフォルトの MXML プロパティgrouping

関連項目

mx.controls.AdvancedDataGrid
mx.collections.Grouping
mx.collections.GroupingField

パブリックプロパティ
 プロパティ定義元
 InheritedchildrenField : String
データアイテム内の子オブジェクトの検出に使用するフィールド名を示します。
HierarchicalData
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  grouping : Grouping
ソースデータに適用される Grouping インスタンスを指定します。
GroupingCollection
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  source : Object
[override] グループ化するフラットデータを含むソースコレクションです。
GroupingCollection
  summaries : Array
ルートレベルのデータ要約を定義する SummaryRow インスタンスの配列です。
GroupingCollection
プロテクトプロパティ
 プロパティ定義元
  timer : Timer
非同期更新操作に関連付けられたタイマーです。
GroupingCollection
パブリックメソッド
 メソッド定義元
  
GroupingCollection()
コンストラクタです。
GroupingCollection
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
  
cancelRefresh():void
更新が非同期的に実行される場合、更新操作をキャンセルしてグループの作成を中止します。
GroupingCollection
 Inherited
canHaveChildren(node:Object):Boolean
ノードに子を含めることができる場合は、true を返します。
HierarchicalData
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
getChildren(node:Object):Object
ノードの子を表すオブジェクトを返します。
HierarchicalData
 Inherited
getData(node:Object):Object
ノードからデータを返します。
HierarchicalData
  
getRoot():Object
[override] グループ化プロパティが設定されている場合は super.source を返し、設定されていない場合は super.source を参照する ICollectionView インスタンスを返します。
GroupingCollection
 Inherited
hasChildren(node:Object):Boolean
ノードに子がある場合は true を返します。
HierarchicalData
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
refresh(async:Boolean = false):Boolean
グループ化をビューに適用します。
GroupingCollection
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
プロテクトメソッド
 メソッド定義元
  
getParent(node:Object):*
ノードの親を返します。
GroupingCollection
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
プロパティの詳細
groupingプロパティ
grouping:Grouping

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



実装
    public function get grouping():Grouping
    public function set grouping(value:Grouping):void

関連項目

mx.collections.GroupingCollection.refresh()
sourceプロパティ 
source:Object[override]

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



実装
    override public function get source():Object
    override public function set source(value:Object):void
summariesプロパティ 
public var summaries:Array

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

      <mx:AdvancedDataGrid id="myADG" 
         width="100%" height="100%" 
         initialize="gc.refresh();">        
         <mx:dataProvider>
             <mx:GroupingCollection id="gc" source="{dpFlat}">
                 <mx:summaries>
                     <mx:SummaryRow summaryPlacement="last">
                         <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:Grouping>
                     <mx:GroupingField name="Region"/>
                     <mx:GroupingField name="Territory"/>
                 </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>

関連項目

mx.collections.SummaryRow
mx.collections.SummaryField
timerプロパティ 
protected var timer:Timer

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

コンストラクタの詳細
GroupingCollection()コンストラクタ
public function GroupingCollection()

コンストラクタです。

メソッドの詳細
cancelRefresh()メソッド
public function cancelRefresh():void

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

getParent()メソッド 
protected function getParent(node:Object):*

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

パラメータ

node:Object — ノードを定義するオブジェクトです。

戻り値
* — ノードを子として含む親ノードです。最上位ノードの場合は null、親を決定できない場合は undefined です。
getRoot()メソッド 
override public function getRoot():Object

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

戻り値
Object — 返すオブジェクトです。
refresh()メソッド 
public function refresh(async:Boolean = false):Boolean

グループ化をビューに適用します。 IGroupingCollection は、グループの変更を自動検出しません。したがって、refresh() メソッドを呼び出してビューを更新する前に、group プロパティを設定する必要があります。

refresh() メソッドを非同期的に適用するには、refresh(true) を呼び出します。

refresh() が同期的に呼び出された場合、クライアントは、kind プロパティの値が CollectionEventKind.REFRESH に設定された CollectionEvent イベントを待機して、refresh() メソッドが完了したことを確認する必要があります。

パラメータ

async:Boolean (default = false) — true の場合は更新が非同期になります。 デフォルトは false で、同期的に更新されることを示します。

戻り値
Boolean — true が返されるのは refresh() メソッドが完了した場合です。false が返されるのは更新が完了していない場合です。これはアイテムがまだ保留中であることを意味する場合があります。



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/collections/GroupingCollection.html