# pasteFromClipboard

클립보드 내용을 현재 대상에 붙여넣습니다. 결과 이벤트에서 적용·건너뛴 셀을 확인합니다.

Canonical: https://grid.syidax.com/ko/docs/methods/pasteFromClipboard/

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

## 무엇을 하는 API인가요

클립보드 내용을 현재 대상에 붙여넣습니다. 결과 이벤트에서 적용·건너뛴 셀을 확인합니다.

Pro 기능 관련 API: Range copy / paste

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

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

```typescript
pasteFromClipboard(): Promise<boolean>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |

반환 타입은 `Promise<boolean>`입니다.

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

## 사용 흐름

등록과 초기화를 마친 Grid 요소에서 grid.pasteFromClipboard(…)를 호출합니다. 반환값은 await로 읽으세요. boolean이나 보고서를 반환하는 메서드는 결과를 확인한 뒤 다음 작업을 진행합니다.

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

## 기능별 설명과 예제

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