Class: GroupingCollection

GroupingCollection

new GroupingCollection()

데이터를 특정 필드에 의거해 그룹핑해서 계층형(트리형)으로 저장하는 콜렉션 컴포넌트입니다.

(GroupingCollection를 사용할 경우 그리드에서 에디팅은 지원되지 않습니다)

See:
Example

레이아웃은 다음과 같은 형식으로 작성됩니다.

<rMateGrid>
     <NumberFormatter id="numfmt" useThousandsSeparator="true"/>
     <PercentFormatter id="percfmt" useThousandsSeparator="true"/>
     <DataGrid id="dg1" horizontalScrollPolicy="auto" fontSize="12" verticalAlign="middle" selectionMode="multipleRows">
         <columns>
             <DataGridColumn dataField="From" width="80"/>
             <DataGridColumn dataField="Subject" width="120" textAlign="center"/>
             <DataGridColumn dataField="ReceiveDate" headerText="Receive" textAlign="center"/>
             <DataGridColumn dataField="SendDate" headerText="Send" textAlign="center"/>
             <DataGridColumn dataField="CC" textAlign="center"/>
             <DataGridColumn dataField="Level" width="50" textAlign="center"/>
             <DataGridColumn dataField="Length" textAlign="center" formatter="{numfmt}"/>
             <DataGridColumn dataField="AttachCount" textAlign="center" formatter="{numfmt}"/>
         </columns>
         <dataProvider>
             <GroupingCollection source="{$gridData}">
                 <Grouping>
                     <GroupingField name="From"/>
                 </Grouping>
             </GroupingCollection>
         </dataProvider>
     </DataGrid>
 </rMateGrid>

Members

asyncboolean

refresh함수의 비동기 실행여부.

Default Value:
  • false

beforeSortingboolean

그룹핑 계산시 먼저 그룹핑 필드에 의해 소팅을 수행할 지 여부

Default Value:
  • true

childrenFieldstring

하위 필드명 설정

자료가 XML로 되어 있으면 하위 노드를 자동으로 감지하나, XML이 아닐 경우 하위 노드의 정보를 가지고 있는 필드를 지정할 필요가 있습니다.

이때 이 속성이 설정되어 있는 경우 속성값으로 필드를 찾아 하위 노드를 찾아 갑니다.

Default Value:
  • "children"

groupingobject

데이터의 그룹핑에 사용되는 정보를 명시하는 Grouping 객체입니다.

See:

sourceobject

GroupingCollection 의 원천 데이터값입니다.

배열이나, XML이 될 수 있습니다.
그룹핑처리된 후에 source로 넣어진 값은 데이터 형식에 따라, 배열이면 ArrayCollection, XML이면 XMLListCollection이 됩니다.

See:
  • 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSource(), setSource(value)

summariesArray

전체 데이터에 대한 합산을 정의한 SummaryRow 인스턴스의 배열입니다.

한개 또는 2개이상의 SummaryRow를 정의할 수 있습니다.

See:

Methods

addEventListener(type, listener)

type에 선언된 이벤트가 발생할 경우 이벤트를 받을 수 있는 listener 함수를 등록합니다.

Name Type Description
type string

이벤트 종류를 표현하는 문자열

listener function

이벤트 발생시 불려질 함수

cancelRefresh()

refresh명령 해제.

refresh명령이 async에 의해 비동기로 실행될 경우 refresh명령을 해제합니다.

refresh()

그룹핑의 재계산을 수행합니다.

데이터가 변경된 경우 반드시 실행해야만 재계산이 일어납니다.

removeEventListener(type, listener)

type에 선언된 이벤트에 연결된 listener 함수를 제거합니다.

Name Type Description
type string

이벤트 종류를 표현하는 문자열

listener function

이벤트 발생시 불려질 함수