addRow (method)

신규 행을 추가합니다.
트리 기능을 사용시에는 parent인자를 지정해 줘야 원하는 레벨로 행을 추가할 수 있습니다.

Syntax

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

Parameters

Name Type Required Description
next object 선택 데이터 로우 객체
(지정한 행의 위에 신규 행이 생성됨. 값이 없으면 맨 마지막행에 생성)
visible boolean 선택 생성 즉시 화면에 반영 여부 (default:1(true))
생성된 행의 Visible 값 설정
focus boolean 선택 생성 후 생성된 행으로 포커스 이동 여부(default:1(true))
parent object 선택 데이터 로우 객체 (트리 사용시 부모에 해당하는 행 지정)
init object 선택 신규 행에 값/옵션 설정 객체
render boolean 선택 생성 후 화면에 렌더링 여부 (default:1(true))
생성된 행의 Visible 여부와는 관련 없음

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"}});

Demo

Read More

Since

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