# applyChartCrossFilter

차트의 선택 동작을 Grid 필터 모델에 반영합니다.

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

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

## 무엇을 하는 API인가요

차트의 선택 동작을 Grid 필터 모델에 반영합니다.

Pro 기능 관련 API: Integrated range charts and pivot chart tools

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

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

```typescript
applyChartCrossFilter(chartId: string, colId: string, action: SyGridChartCrossFilterAction, categories: unknown[]): Promise<SyGridChartCrossFilterResult>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| chartId | 필수 | string |
| colId | 필수 | string |
| action | 필수 | SyGridChartCrossFilterAction |
| categories | 필수 | unknown[] |

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

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [선택 데이터를 차트로](https://grid.syidax.com/ko/docs/features/integrated-charts.md) — Grid의 범위를 차트로 연결하면 같은 데이터로 표와 그래프를 함께 읽을 수 있습니다. 숫자 값만 고르면 되는 것이 아니라 범주 열과 값 열을 차트 종류에 맞게 선택해야 합니다.