addRow (method)

신규 행을 추가합니다.
트리 기능 사용 시에는 parent 인자를 지정해야 원하는 레벨로 행을 추가할 수 있습니다.
소계(makeSubTotal) 그룹 안에 행을 추가해도 소계 계산에 반영되지 않습니다.

Syntax

object addRow( next, visible, focus, parent, init, render );

Parameters

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)

Return Value

object : 생성된 데이터 로우 객체

Example

// 맨 위에 신규 행을 생성합니다.
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();              // 한 번에 화면 반영

Demo

Read More

Since

product version desc
core 8.0.0.0 기능 추가
core 8.0.0.3 init 인자 추가
core 8.0.0.20 render 인자 추가