setFormulaRow (method)

FormulaRow(합계행)에 계산을 변경(Sum,Avg,Min,Max)하거나 행을 감출 수 있습니다.
컬럼에 FormulaRow 설정이 없어도 이 함수를 호출하면 동적으로 합계행이 생성됩니다.
이 함수는 호출할 때마다 지정한 내용으로 FormulaRow 설정 전체를 다시 지정합니다. 그래서 일부 열만 지정하거나 감추기용으로 visible만 지정해 호출하면, 열에 설정했던 기존 합계 설정이 사라집니다. 기존 합계를 유지하려면 호출 시 기존 열 설정까지 함께 지정하거나 noclear 인자를 true로 사용하세요.

Syntax

void setFormulaRow( val, cols, visible, render, noclear );

Parameters

Name Type Required Description
val string | object 필수 설정할 계산 방식 ('Sum','Avg','Min','Max' 중 하나)
또는 object 형태로 설정시 {"ColName1":"Sum","ColName2":"Avg"} 식으로 설정 가능
(object형을 사용시에는 cols 인자는 필요 없음)
cols string 선택 계산할 열이름(복수개인 경우 ,를 구분자로 연결한 문자열)
visible boolean 선택 FormulaRow 보임 여부
0(false):FormulaRow(합계행) 감춤 (default)
1(true):FormulaRow(합계행) 보임
render boolean 선택 즉시 화면 반영 여부
해당 기능을 0(false)로 사용했을 경우, 작업 마무리 시에 rerender()를 실행해야 화면에 반영 됩니다.
0(false):반영 안함 (default)
1(true):즉시 반영
noclear boolean 선택 기존에 설정된 다른 열의 수식 유지 여부
0(false):호출 시 다른 열의 기존 수식을 모두 초기화하고 지정한 열만 설정 (default)
1(true):다른 열의 기존 수식은 유지하고 지정한 열만 갱신

Return Value

boolean : 설정 완료 여부

Example

//합계행에 계산을 평균값으로 변경
sheet.setFormulaRow( "Avg", "AMT1,AMT2", 1, 1 );

//합계행을 감춘다.
sheet.setFormulaRow({visible:0, render:1});

// A, B 열의 수식을 Min으로 설정, 나머지 열의 기존 수식은 유지
sheet.setFormulaRow({
    val: { "A": "Min", "B": "Min" },
    visible: 1,
    render: true,
    noclear: true   // 기존 다른 열 수식 유지
});

Read More

Since

product version desc
core 8.0.0.0 기능 추가
core 8.4.0.14 noclear 인자 추가