# applyColumnState

저장한 열 상태를 복원합니다. 현재 열 식별자와 일치하는지 확인하세요.

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

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

## 무엇을 하는 API인가요

저장한 열 상태를 복원합니다. 현재 열 식별자와 일치하는지 확인하세요.

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

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

```typescript
applyColumnState(state: ColumnStateEntry[], opts?: ApplyColumnStateOptions): Promise<void>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| state | 필수 | ColumnStateEntry[] |
| opts | 선택 | ApplyColumnStateOptions |

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

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [열 크기와 고정](https://grid.syidax.com/ko/docs/features/column-operations.md) — 너비·순서·고정·숨김은 서로 독립적인 열 상태입니다. 주문 번호는 고정하고 보조 정보는 숨기며 긴 제품명만 넓히는 식으로 조합할 수 있습니다.