addFormula (method)

특정 행, 열, 셀에 포뮬러를 추가합니다.
rowcol이 없는 경우 전체 데이터에 포뮬러를 추가합니다.
해당 기능 사용 시 CanFormula가 자동적으로 true로 설정됩니다. CalcOrder에 설정한 포뮬러가 순차적으로 추가됩니다. 자세한 내용은 7장 Formula appendix를 참고하세요.

Syntax

boolean addFormula( formula, row, col, attr, render );

Parameters

Name Type Required Description
formula function | string 필수 추가하고자 하는 포뮬러
row object | array[object] 선택 데이터 로우 객체 또는 데이터 로우 객체 배열
col string 선택 열 이름
attr string 선택 추가하려는 attribute + Formula의 속성명
render boolean 선택 즉시 화면 반영 여부
해당 기능을 0(false)로 사용했을 경우, 작업 마무리 시에 rerender()를 실행해야 화면에 반영 됩니다.
0(false):반영 안함
1(true):즉시 반영 (default)

Return Value

boolean : 함수 정상 동작 여부. (인자값이 잘못되어 수행되지 못한 경우에는 false 리턴)

Example

// 컬럼 추가 후 Formula 도 동적으로 추가
sheet.addCol( "IntData", 0, -1, {Type:"Int",Header:"추가Int컬럼",Width:200,CanEdit:1}, true);

var colorFormula = function (param) {
    if (param.Row && param.Row["IntData"] === 0) {
        return "#FFD9FA"
    }
}
// 데이터 행의 배경색을 조건에 따라 변경
sheet.addFormula(colorFormula, "", "", "Color");

////////////////////////////////////////////
var Formula = function (param) {
    if (param.Row["IntData"] > 100) {
        return true
    } else {
        return false
    }
}
// IntData의 값에 따라 체크박스 열의 체크 변경
sheet.addFormula(Formula, "", "CheckData", "", true);

////////////////////////////////////////////
// 시트의 첫번째 행의 TextData 열에 값을 IntData 열과 FloatData 열의 합으로 변경
sheet.addFormula("IntData + FloatData", sheet.getFirstRow(), "TextData", "", true);

Read More

Since

product version desc
core 8.2.0.4 기능 추가