# copyRows (method)

> 지정한 행들을 특정 위치로 복사합니다.
> 값뿐 아니라 셀 속성(색상, 글자색 등)도 함께 복사됩니다. (`empty: true`로 호출하면 데이터를 복사하지 않고 행만 추가됩니다.)

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

### Syntax

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

### Parameters

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)`) 상태로 변경 시키고 복사

### 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

- copyRow method
- addRow method
- moveRow method
- onRowAdd event
- onAfterRowCopy event
- onAfterRowAdd event

### Since

product | version | desc
--- | --- | ---
core | 8.0.0.0 | 기능 추가