# setState

전체 또는 지정한 화면 상태 조각을 복원하고 적용·문제 보고서를 반환합니다. appliedSlices에 있는 부분만 실제 반영됩니다.

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

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

## 무엇을 하는 API인가요

전체 또는 지정한 화면 상태 조각을 복원하고 적용·문제 보고서를 반환합니다. appliedSlices에 있는 부분만 실제 반영됩니다.

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

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

```typescript
setState(state: SyGridState, options?: GridStateApplyOptions): Promise<SyGridStateApplyReport>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| state | 필수 | SyGridState |
| options | 선택 | GridStateApplyOptions |

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

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [설정과 데이터의 기본 원리](https://grid.syidax.com/ko/docs/guides/concepts.md)
- [API 호출과 이벤트 연결](https://grid.syidax.com/ko/docs/guides/data-event-access.md)