# getGroupCheckStates

행 그룹의 선택 상태를 계산합니다. 접힌 그룹·행 ID 없음·다른 행 모델 등 확실히 판단할 수 없는 경우 거절 사유를 반환합니다.

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

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

## 무엇을 하는 API인가요

행 그룹의 선택 상태를 계산합니다. 접힌 그룹·행 ID 없음·다른 행 모델 등 확실히 판단할 수 없는 경우 거절 사유를 반환합니다.

Pro 기능 관련 API: Row grouping, built-in aggregation and group totals

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

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

```typescript
getGroupCheckStates(options?: SyGridGroupCheckStatesOptions): Promise<SyGridGroupCheckStatesReport>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| options | 선택 | SyGridGroupCheckStatesOptions |

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

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [그룹과 집계](https://grid.syidax.com/ko/docs/features/row-grouping.md) — 행 그룹은 같은 지역이나 팀에 속한 원본 행을 접고 펼칠 수 있게 묶습니다. 열 그룹이 머리글을 묶는 것과 달리, 행 그룹은 표시 행과 집계 결과를 바꿉니다.