신규 행을 추가합니다.
트리 기능 사용 시에는parent인자를 지정해야 원하는 레벨로 행을 추가할 수 있습니다.
소계(makeSubTotal) 그룹 안에 행을 추가해도 소계 계산에 반영되지 않습니다.
object addRow( next, visible, focus, parent, init, render );
| Name | Type | Required | Description |
|---|---|---|---|
| next | object |
선택 | 데이터 로우 객체 (지정한 행의 위에 신규 행이 생성됨. 값이 없으면 맨 마지막행에 생성) |
| visible | boolean |
선택 | 생성된 행의 보임/감춤 설정0(false):감춤1(true):보임 (default) |
| focus | boolean |
선택 | 생성 후 생성된 행으로 포커스 이동 여부0(false):포커스 이동 안함1(true):포커스 이동 (default) |
| parent | object |
선택 | 데이터 로우 객체 (트리 사용시 부모에 해당하는 행 지정) |
| init | object |
선택 | 신규 행에 값/옵션 설정 객체 |
| render | boolean |
선택 | 화면 갱신 여부0(false):화면 갱신 안함1(true):즉시 화면 갱신 (default) |
object : 생성된 데이터 로우 객체
// 맨 위에 신규 행을 생성합니다.
sheet.addRow( {"next":sheet.getFirstRow()} )
// 현재 포커스가 위치한 행의 위에 신규 행을 생성합니다.
sheet.addRow( {"next":sheet.getFocusedRow()} );
// 현재 포커스가 위치한 행의 아래에 신규 행을 생성합니다.(focus 이동)
sheet.addRow( {"next":sheet.getNextRow(sheet.getFocusedRow())});
// 트리 사용시 현재 포커스가 위치한 행의 아래에 같은 레벨의 신규 행을 생성합니다.
var nextRow = sheet.getNextSiblingRow(sheet.getFocusedRow());
var parentRow = sheet.getFocusedRow().parentNode;
sheet.addRow( {"next":nextRow, "parent":parentRow} );
// 현재 포커스가 된 행의 자식 노드로 신규 행을 추가합니다.
// next 로 기준 행을 주지 않으면, 자식 노드 맨 마지막에 행이 추가됩니다.
sheet.addRow({"parent":sheet.getFocusedRow()});
// 현재 포커스가 위치한 행의 위에 신규 행을 생성합니다.
// 신규 행의 CONTRACTNO과 CARNO 열에 값을 설정합니다.
// 신규 행의 배경 색상을 빨간색으로 설정합니다.
sheet.addRow({"next":sheet.getFocusedRow(), "init":{"CONTRACTNO":"S155", "CARNO":"1234123", Color:"red"}});
// render:0으로 행 추가 후 Formula 계산 및 화면 반영
sheet.addRow({init:{X:1, Y:6}, render:0});
sheet.calculate(false, false); // Formula 계산 (렌더링 안함)
sheet.rerender(); // 한 번에 화면 반영
| product | version | desc |
|---|---|---|
| core | 8.0.0.0 | 기능 추가 |
| core | 8.0.0.3 | init 인자 추가 |
| core | 8.0.0.20 | render 인자 추가 |