# 행 복사

한 행의 표시 열을 탭으로 구분해 복사합니다. 스프레드시트에 붙여 넣으면 각 열이 셀로 나뉘므로 한 주문의 여러 값을 옮길 때 유용합니다.

Canonical: https://grid.syidax.com/ko/docs/features/row-copy/

<a id="understand"></a>

## 동작 원리와 선택 기준

copyRowAt은 현재 표시 위치를 받습니다. 업무 ID로 행을 선택한 앱은 그 ID가 화면에서 어디에 있는지 확인한 뒤 복사해야 합니다.

코드의 grid는 설치와 연결 장에서 준비한 Grid 요소입니다. 예제마다 필요한 데이터·설정을 확인하고, 코드에서 소개하는 앱 함수와 서버 주소는 프로젝트에 맞게 구현하세요.

- [설치와 연결 · 공통 예제 데이터](https://grid.syidax.com/ko/docs/guides/getting-started.md)

<a id="example-1"></a>

## 예제 1. 현재 첫 행 복사

사용자의 버튼 클릭에 행 복사를 연결합니다.

```javascript
console.log(await grid.copyRowAt(0));
```

결과 확인: 표시 열의 값이 TSV로 복사됩니다. 숨긴 열은 표시 열 기반 복사에 포함되지 않습니다.

<a id="example-2"></a>

## 예제 2. 간단 보기에서 복사

단가 열을 숨긴 뒤 같은 행을 복사합니다.

```javascript
await grid.hideColumn('price');
// 사용자 복사 버튼에서 호출
console.log(await grid.copyRowAt(0));
```

결과 확인: 스프레드시트에 붙여 넣었을 때 표시 중인 열 순서와 개수를 비교할 수 있습니다.

<a id="example-3"></a>

## 예제 3. 여러 행과 비교

주문 여러 건을 옮겨야 한다면 한 행 복사를 반복하기보다 범위 복사나 CSV 내보내기를 선택합니다.

결과 확인: 행 하나의 일회성 전달과 파일 기반 일괄 전달을 사용자에게 구분해서 제공합니다.

<a id="pitfalls"></a>

## 조합할 때와 문제를 해결할 때

셀 안의 탭·줄바꿈·수식처럼 보이는 텍스트는 붙여넣는 앱에서 다르게 해석될 수 있습니다. 실제 대상 앱으로 확인하세요.

선택 체크박스가 있다고 해서 copyRowAt이 선택된 행을 자동 선택하지 않습니다. 인수의 표시 행 위치를 명시해야 합니다.

<a id="related-api"></a>

## 이 기능에 사용하는 API

- [copyRowAt](https://grid.syidax.com/ko/docs/methods/copyRowAt.md) — 지정한 표시 행을 복사하고 성공 여부를 반환합니다.

<a id="next"></a>

## 함께 읽기

- [행·열·ID의 관계](https://grid.syidax.com/ko/docs/guides/concepts.md)
- [결과와 이벤트 연결](https://grid.syidax.com/ko/docs/guides/data-event-access.md)
- [Features에서 살펴보기](https://grid.syidax.com/grid/row-copy) — 직접 체험 가능한 범위는 해당 가이드에 안내되어 있습니다.