# fillRange

소스 범위의 값이나 패턴으로 목표 범위를 채우고 적용·거절 결과를 반환합니다.

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

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

## 무엇을 하는 API인가요

소스 범위의 값이나 패턴으로 목표 범위를 채우고 적용·거절 결과를 반환합니다.

Pro 기능 관련 API: Fill handle

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

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

```typescript
fillRange(options: SyGridFillRangeOptions): Promise<SyGridFillRangeReport>
```

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

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

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [값 채우기](https://grid.syidax.com/ko/docs/features/fill-handle.md) — 채우기 핸들은 기준 범위의 값을 복사하거나 규칙을 확장합니다. 손잡이를 드래그하는 UI와 fillRange API는 편집 가능 여부·검증·이력을 함께 고려합니다.