addCol (method)

이미 생성된 시트에 동적으로 열을 추가합니다.

Syntax

object addCol( name, section, pos, param, visible, render );

Parameters

Name Type Required Description
name string 필수 추가할 열 이름
section number 선택 추가될 영역
0:좌측 영역
1:가운데 영역 (default)
2:우측영역
pos number 선택 section 내에 위치 (0부터 시작, -1입력시 우측 끝 열) (default: 0)
param object 선택 열의 속성 (ex : {Type:"Text", Header:"타이틀", Width:120, CanEdit:0} )
열 이름은 name 인자로 넘기며, param에는 Name을 넣지 않습니다.
visible boolean 선택 생성 후 화면에 Visible 여부
0(false):감춤 (default)
1(true):보임
생략하면 열이 감춰진 채 추가됩니다.
render boolean 선택 즉시 화면 반영 여부
해당 기능을 0(false)로 사용했을 경우, 작업 마무리 시에 rerender()를 실행해야 화면에 반영됩니다.
0(false):반영 안함
1(true):즉시 반영 (default)

Return Value

object : 생성된 열 객체(name 인자에 이미 존재하는 열 이름을 입력하는 경우 null 이 리턴됨)

Example

// 가운데 영역 마지막에 "memo" 열을 추가
sheet.addCol("memo", 1, -1, { Header: "비고", Type: "Text", Width: 150, CanEdit: 1 }, true);

// 여러 열을 추가할 때는 render 를 false 로 주고, 모두 추가한 뒤 한 번만 그립니다.
var adds = [
    { name: "confirm", param: { Header: "확인", Type: "Bool", Width: 60, CanEdit: 1 } },
    { name: "grade",   param: { Header: "등급", Type: "Text", Width: 80, CanEdit: 0 } }
];
for (var i = 0; i < adds.length; i++) {
    // 열 이름은 첫 번째 인자로 넘깁니다. param 에는 Name 을 넣지 않습니다.
    sheet.addCol(adds[i].name, 1, -1, adds[i].param, true, false);
}
sheet.rerender();

이미 존재하는 열 이름으로 호출하면 추가되지 않고 null 이 반환됩니다.
열 구성 전체가 바뀌면 IBSheet.create로 다시 만드는 편이 단순합니다.

Try it

Read More

Since

product version desc
core 8.0.0.0 기능 추가
core 8.0.0.17 render 인자 추가