addFormula (method)

특정 행·열·셀에 포뮬러를 동적으로 추가합니다.
이 함수 사용 시 CanFormula가 자동으로 true로 설정되고, CalcOrder에도 추가한 포뮬러가 자동으로 등록됩니다.
row와 col이 생략되면 전체 데이터에 적용됩니다. 자세한 내용은 Formula col을 참고하세요.

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

// 컬럼 동적 추가 후 attribute+Formula로 배경색 적용 (attr="Color")
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");


// 다른 컬럼 값에 따라 체크박스 자동 체크 (function 형식)
var Formula = function(param) {
    return param.Row["IntData"] > 100;
};
sheet.addFormula(Formula, "", "CheckData", "", true);


// 다른 컬럼 합산을 string 형식으로 특정 셀에만 적용
sheet.addFormula("IntData + FloatData", sheet.getFirstRow(), "TextData", "", true);

Read More

Since

product version desc
core 8.2.0.4 기능 추가