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 이벤트 발생시 불려질 함수