해당 컬럼의 통계 타입 값을 설정하는 API이다. 컬럼의 통계 타입은 그리드 칼럼의 데이터부의 statisticsrow_type 속성에 정의된다.
| Parameters | Type | Description |
|---|---|---|
| nColumn | short | 컬럼 인덱스 (Zero-Base) |
| nStatType | short | 통계 타입 (Remark 참조) |
| bRefresh | BOOL | [옵션] 그리드 리프레쉬 여부(기본값 false) |
| Type | Description |
|---|---|
| BOOL | 성공/실패 여부 |
nColumn, nStatType 파라미터 값이 유효하지 않은 경우, false 값이 리턴된다.
이 API를 호출하는 즉시 통계행이 다시 계산 되지 않는다. 통계 타입을 모두 변경한 후 통계행이 재계산 될 필요가 있는 시점에 refresh API를 호출해야, 통계 정보가 다시 계산되어 화면에 표시된다.
그리드 통계행은 그리드의 속성중에 statistics_row 속성을 통해서 정의하며, 통계 방식은 statistics_row 속성창에서 operation 속성에 의해서 결정된다.
operation 속성이 5(칼럼별 정의)인 경우에 한하여 칼럼별 통계 타입이 반영되고, 그 외의 경우에는 반영되지 않는다.
* nStatType 파라미터 값 0 : 합계 1 : 평균 2 : 갯수 3 : 최소값 4 : 최대값 5 : 사용자정의
그리드 칼럼의 통계 타입은 getcolumnstatrowtype 함수를 통해서 구할 수 있다.
통계 정보는 칼럼의 statistics_show 속성에 의해서 화면에 보이는 것이 결정된다.
통계 정보는 칼럼 데이터부의 data_type 속성이 0(숫자)인 경우에만 적용된다.
bRefresh 값이 false인 경우, 변경된 내용을 표시하기 위해서는 refresh 함수를 호출해야 한다.
만약 많은 수의 칼럼에 대해서 루핑 돌면서 호출하는 경우라면, 해당 파라미터를 false로 주고, 루핑처리 끝난 이후에 그리드 refresh 함수를 호출하는 것이 속도면에서 훨씬 빠릅니다.
// 그리드 이름 : grdNormal
// 벼튼 이름 : btnTestSetColumnStatRowType
// 그리드의 개별 컬럼에 대한 컬럼별 통계 타입을 설정
// 그리드의 통계 타입이 칼럼별 정의로 설정되어 있음
// 그리드 칼럼별 통계를 설정하는 버튼 클릭 이벤트 처리
function btnTestSetColumnStatRowType_on_mouseup(objInst)
{
// 1번째 칼럼을 갯수로 설정
grdNormal.setcolumnstatrowtype(1, 2);
// 2번째 칼럼을 최대값으로 설정
grdNormal.setcolumnstatrowtype(2, 4);
// 칼럼별 통계 타입 설정을 모두 완료하고,
// refresh 함수를 호출하여 통계행 재계산
grdNormal.refresh();
}