# clipboardPasted

붙여넣기 처리 결과를 알립니다. 적용 수·건너뛴 수·시작 위치·실제 변경 목록을 함께 확인합니다.

Canonical: https://grid.syidax.com/ko/docs/events/clipboardPasted/

<a id="meaning"></a>

## 무엇을 하는 API인가요

붙여넣기 처리 결과를 알립니다. 적용 수·건너뛴 수·시작 위치·실제 변경 목록을 함께 확인합니다.

Pro 기능 관련 API: Range copy / paste

<a id="contract"></a>

## 입력과 결과의 정확한 타입

```typescript
clipboardPasted: {
    applied: number;
    skipped: number;
    top: number;
    left: number;
    changes: GridCellValueChangedDetail[];
  }
```

<a id="usage"></a>

## 사용 흐름

grid.addEventListener('clipboardPasted', handler)로 구독합니다. 실제 결과는 event.detail에 들어 있고 이름의 대소문자를 구분합니다. 화면을 닫을 때 구독을 해제하세요.

```javascript
const controller = new AbortController();
grid.addEventListener('clipboardPasted', event => {
  console.log(event.detail);
}, { signal: controller.signal });
// 화면을 해제할 때 controller.abort();
```

<a id="types"></a>

## 관련 타입 읽기

- [GridCellValueChangedDetail](https://grid.syidax.com/ko/docs/types/GridCellValueChangedDetail.md)

<a id="recipes"></a>

## 기능별 설명과 예제

- [범위 복사와 붙여넣기](https://grid.syidax.com/ko/docs/features/range-clipboard.md) — 직사각형 범위의 값을 복사하고 같은 행·열 배치로 붙여넣습니다. 시작 셀을 기준으로 대상이 결정되며 편집 불가·권한·검증 규칙을 함께 적용합니다.