해당 컬럼의 소계 타입(midstatistics_type)을 설정하는 API이다.
| Parameters | Type | Description |
|---|---|---|
| nColumn | short | 컬럼 인덱스 (Zero-Base) |
| nMidStatType | short | 소계 타입 (Remark 참조) |
| bRefresh | BOOL | [옵션] 그리드 리프레쉬 여부(기본값 false) |
| Type | Description |
|---|---|
| BOOL | 정상 여부 |
파라미터 값이 유효하지 않은 경우, false가 리턴된다.
bRefresh 파라미터가 false인 경우, refresh API를 호출해야 소계 정보가 다시 계산되어 화면에 표시된다.
만약 그리드에 대해 많은 작업을 수행하는 경우라면, 해당 파라미터를 false로 주고, 작업 완료시 그리드 refresh 함수를 호출하는 것이 속도면에서 훨씬 빠릅니다.
그리드 소계행은 그리드의 속성중에 mid_statistics 속성을 통해서 정의하며, 통계 방식은 mid_statistics 속성창에서 소계행 내용 속성에 의해서 결정된다.
소계행 내용 속성이 칼럼별 정의인 경우에 한하여 칼럼별 소계 타입이 반영되고, 그 외의 경우에는 반영되지 않는다.
* nMidStatType 파라미터 값 0 : 합계 1 : 평균 2 : 갯수 3 : 최소값 4 : 최대값 5 : 사용자정의
그리드 칼럼의 소계 타입은 getcolumnmidstattype 함수를 통해서 구할 수 있다.
소계 정보는 칼럼의 midstatistics_show 속성에 의해서 화면에 보이는 것이 결정된다.
소계 정보는 칼럼 데이터부의 data_type 속성이 0(숫자)인 경우에만 적용된다.
소계 정보는 칼럼 데이터부의 base_midstatistics 속성을 true로 설정한 칼럼의 데이터를 기준으로 계산되며, 모든 칼럼이 false인 경우, 0번재 인덱스 칼럼의 데이터를 기준으로 계산힌다.
그리드 소계 타입은 setmidstatistics 함수를 통해서 설정할 수 있다.
// 그리드 이름 : grdNormal
// 벼튼 이름 : btnTestSetColumnMidStatType
// 그리드의 개별 컬럼에 대한 컬럼별 소계 타입을 설정
// 그리드의 소계 타입이 칼럼별 정의로 설정되어 있음
// 그리드 칼럼별 소계 타입을 설정하는 버튼 클릭 이벤트 처리
function btnTestSetColumnMidStatType_on_mouseup(objInst)
{
// 1번째 컬럼을 합계로 설정
grdNormal.setcolumnmidstattype(0, 0);
// 2번째 컬럼을 갯수로 설정
grdNormal.setcolumnmidstattype(1, 2);
// 3번재 컬럼을 최대값으로 설정
grdNormal.setcolumnmidstattype(2, 4);
// 칼럼별 소계 타입 설정을 모두 완료하고,
// refresh 함수를 호출하여 소계 재계산
grdNormal.refresh();
}