ShowSubSum (sum method)

특정 컬럼의 데이터를 기준으로 소계와 누계를 계산하여 표시합니다.
이 메소드는 데이터를 조회하는 메소드를 호출하기 이전에 호출하여야 하며, 설정을 변경한 경우 다시 데이터를 조회해야 적용 됩니다.
제약사항 단위데이터행, 트리구조, 서버페이징 모드에서는 지원하지 않습니다.

Syntax

ObjId.ShowSubSum([opt]);

Info

Parameter Type Required Description
opt Object 필수 설정 옵션
opt.StdCol Number orString 필수 기준 컬럼 Index 또는 SaveName
opt.SumCols String 필수 소계가 계산되어야 할 컬럼 Index를 |로 연결한 문자열
opt.Sort String 선택 기준 컬럼의 Sort 처리 방식
- "" : 사용 안함
- asc : 오름차순 정렬
- desc : 내림차순 정렬
opt.ShowCumulate Boolean 선택 소계에 대한 누계 표시 여부 (Default: 0)
opt.CaptionCol Long 선택 소계 대표 글자인 "소계:" + 기준값을 설정할 컬럼 (Default: 숨겨지지 않은 첫컬럼)
opt.CaptionText String 선택 소계 대표 글자 포맷
소계(누계)를 의미하는 %s 예약어와 기준값을 의미하는 %col 예약을 이용하여 소계 대표 글자 출력 포맷을 설정
- 설정 예제 : [%s] %col - 출력: [소계] 기준컬럼의 값
opt.AvgCols String 선택 소계 행에 평균으로 계산되어야 할 컬럼 Index를 |로 연결한 문자열 (Defuault: "")
opt.CntCol String 선택 소계 행에 건수 표현할 컬럼의 Index 혹은 SaveName
opt.Position String 선택 소계행 생성 위치 설정
- bottom : 그룹 하단 표시
- top : 그룹 상단 표시
- bottomAll : 최하단 표시
- topAll : 최상단 표시
opt.OtherColText String 선택 CaptionCol 이외의 컬럼에 설정할 글자를 ;으로 연결한 문자열 (Default: "")
opt.Mode Number 선택 소계행 표시 방법
- 0 : 모든 대상 그룹에 대한 소계행 표시
- 1 : 대상 그룹이 2개 이상인 그룹에 대해서만 소계행 표시

Returns

none

Example

// Index가 1인 컬럼을 기준으로 소계 표현
mySheet.ShowSubSum([
  {"StdCol": 1, "SumCols": "3|4|5"}
]);

// 누계 표시
mySheet.ShowSubSum([
  {"StdCol": 1, "SumCols": "3|4|5", "ShowCumulate": 1}
]);

// Index가 1인 컬럼, 2인 컬럼 기준의 다중 소계 표현
mySheet.ShowSubSum([
  {"StdCol": 1, "SumCols": "3|4|5"}
  {"StdCol": 2, "SumCols": "3|4|5", "CaptionCol": 2}
]);

Since

version desc
7.0.0.0
7.0.13.12 Sort 속성의 타입 변경 및 오름차순 내림차순 설정 지원
7.0.13.38 Position 속성 추가
소계 후 컬럼 Sort 기능 지원
7.0.13.40 OtherColText 속성 추가
7.0.13.51 Mode 속성 추가
7.0.13.163 CntCol 속성 추가