Interface CellRange

선택된 셀들의 사각형 범위를 네 모서리 인덱스로 나타냅니다(엑셀의 A1:C5 같은 개념). 범위 선택 기능이 이 값을 만들어 내고, 수식의 참조 대상과 차트의 데이터 소스가 이 좌표를 그대로 읽어 씁니다. / A rectangular block of selected cells, given as its four corner indexes (think of a spreadsheet's A1:C5). Range selection produces it; cell formulas and chart sources consume the same coordinates.

좌표가 가리키는 것 / What the coordinates mean:

• 행 인덱스(startRow/endRow)는 "화면에 보이는 순서"입니다. 그룹·트리의 가상 행이나 펼쳐진 상세 행까지 포함한 순서라서, 정렬·필터만 반영한 순수 데이터 순서와는 다를 수 있습니다. / Row indexes are in on-screen order — they include group/tree pseudo-rows and expanded detail rows, so they can differ from the pure data order that reflects only sort/filter.
• 컬럼 인덱스(startCol/endCol)는 "지금 보이는 컬럼들" 기준입니다(숨긴 컬럼 제외). 컬럼을 다시 보이게 하면 재렌더 때 좌표 표시가 갱신됩니다. / Column indexes count only currently visible columns (hidden ones excluded); un-hiding a column refreshes the displayed coordinates on the next render.

주의 / Note: 선택의 "영구 신원"은 이 인덱스가 아니라 안정적인 (행 id × field) 앵커로 저장됩니다. CellRange 는 어디까지나 "지금 화면에 투영된" 사각형 표현입니다. / The persistent identity of a selection is stored as a stable (rowId × field) anchor, not as these indexes — CellRange is only the "currently projected onto screen" rectangle.