copyRows (method)

지정한 행들을 특정 위치로 복사합니다.
내부적으로는 여러개 행을 복사 후 추가(ctrl+c, ctrl+v)하는 행위이기 때문에 onAfterRowCopy 이벤트와 onAfterRowAdd이벤트가 발생합니다.

Syntax

object copyRows( rows, next, empty, parent, child, forceVisible );

Parameters

Name Type Required Description
rows object 필수 데이터 로우 객체 배열
next object 선택 데이터 로우 객체
(next로 지정한 행의 위에 rows행들이 복사됨. 값이 없으면 마지막 행에 복사)
empty boolean 선택 데이터는 없이 행의 속성만 복사 여부(default:0(false))
parent object 선택 데이터 로우 객체 (트리 사용시 부모에 해당하는 행 지정)
child boolean 선택 트리 사용시 자식행도 복사할 지 여부
forceVisible boolean 선택 보이지 않는 행을 복사할 때 보이도록 설정

Return Value

array[row object] : 복사된 데이터 로우 객체

Example

//AR5,AR6,AR9행을 최상단에 복사
sheet.copyRows({rows:[
    sheet.getRowById("AR5"),
    sheet.getRowById("AR6"),
    sheet.getRowById("AR9")
    ], next:sheet.getFirstRow()});




//CHK열에 체크한 행들을 sheet2에 맨 마지막 행으로 복사
function work(){
    var chkRows = sheet.getRowsByChecked("CHK");
    sheet2.copyRows({rows:chkRows});
}

Read More

Since

product version desc
core 8.0.0.0 기능 추가