# setCanonicalRanges

정규 범위 입력으로 셀 선택을 바꾸고 변경 결과를 반환합니다.

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

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

## 무엇을 하는 API인가요

정규 범위 입력으로 셀 선택을 바꾸고 변경 결과를 반환합니다.

Pro 기능 관련 API: Cell range selection

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

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

```typescript
setCanonicalRanges(ranges: SyGridCellRangeInput[]): Promise<SyGridCanonicalChange[]>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| ranges | 필수 | SyGridCellRangeInput[] |

반환 타입은 `Promise<SyGridCanonicalChange[]>`입니다.

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [셀 범위 선택](https://grid.syidax.com/ko/docs/features/range-selection.md) — 셀 범위는 여러 행·열에 걸친 직사각형입니다. 복사·붙여넣기·채우기·차트 생성이 사용할 범위를 정하며, 선택 자체는 값을 수정하지 않습니다.