지정한 행들을 특정 위치로 복사합니다.
내부적으로는 여러개 행을 복사 후 추가(ctrl+c, ctrl+v)하는 행위이기 때문에 onAfterRowCopy 이벤트와 onAfterRowAdd이벤트가 발생합니다.
object copyRows( rows, next, empty, parent, child, forceVisible );
Name | Type | Required | Description |
---|---|---|---|
rows | object |
필수 | 데이터 로우 객체 배열 |
next | object |
선택 | 데이터 로우 객체 (next로 지정한 행의 위에 rows행들이 복사됨. 값이 없으면 마지막 행에 복사) |
empty | boolean |
선택 | 복사 시 데이터 포함 여부1(true) 로 설정하여 사용 시 onAfterRowCopy 이벤트 미발생0(false) :데이터 포함 (default )1(true) :데이터 미포함 |
parent | object |
선택 | 데이터 로우 객체 (트리 사용시 부모에 해당하는 행 지정) |
child | boolean |
선택 | 트리 사용시 자식행도 복사할 지 여부0(false) :자식행 미포함 (default )1(true) :자식행 포함 |
forceVisible | boolean |
선택 | 보이지 않는 행을 복사할 때 보이도록 설정0(false) :행을 감춤(Visible:0(false) ) 상태로 변경 시키고 복사 (default )1(true) :행을 보임(Visible:1(true) ) 상태로 변경 시키고 복사 |
array[row object] : 복사된 데이터 로우 객체들
//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});
}
product | version | desc |
---|---|---|
core | 8.0.0.0 | 기능 추가 |