# applySpillFormula

동적 배열 수식을 충돌 정책에 따라 원자적으로 적용합니다. 충돌·거절·화면에 그려지지 않은 영역을 보고서에서 확인합니다.

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

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

## 무엇을 하는 API인가요

동적 배열 수식을 충돌 정책에 따라 원자적으로 적용합니다. 충돌·거절·화면에 그려지지 않은 영역을 보고서에서 확인합니다.

Pro 기능 관련 API: Built-in formulas, references, dependency recalculation and calculated columns

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

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

```typescript
applySpillFormula(input: SyGridSpillApplyInput): Promise<SyGridSpillApplyResult>
```

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

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

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [수식 계산](https://grid.syidax.com/ko/docs/features/formulas.md) — 수식은 =로 시작하는 문자열을 계산해 셀에 결과를 표시합니다. 예를 들어 =SUM(A1:A3)은 원본 열 정의의 첫 번째 열과 원본 데이터의 첫 세 행을 참조합니다.