[]
        
(Showing Draft Content)

테이블 시트 데이터 범위

워크시트 영역에 테이블 시트를 데이터 범위로 렌더링하면, 테이블 시트와 데이터 범위는 동일한 인스턴스가 됩니다. 테이블 시트에서 변경된 내용은 데이터 범위에 자동으로 반영되며, 그 반대의 경우도 마찬가지입니다. 이를 통해 두 표현 간의 일관성(consistency)이 유지됩니다.


데이터 범위는 정렬, 필터링, 스타일링 등 대부분의 테이블 시트 기능을 상속합니다. 이를 통해 워크시트의 특정 영역에서도 테이블 시트의 강력한 기능을 활용할 수 있으며, 유연하고 일관된 방식으로 데이터를 관리 및 표시할 수 있습니다. 따라서, 원본 테이블 시트가 제거되면 해당 데이터 범위도 함께 제거됩니다.

다음 샘플 코드는 테이블 시트를 워크시트에 데이터 범위로 렌더링하는 방법을 보여줍니다:

var tableSheetName = "TableSheet1";
var dataRangeName = "TableSheetDataRange";
var dataRangeStartRow = 2;
var dataRangeStartCol = 2;
sheet.dataRanges.add(dataRangeName, tableSheetName, new GC.Spread.Sheets.Range(dataRangeStartRow, dataRangeStartCol, -1, -1));

스크롤 시 테이블 시트 헤더가 계속 표시되도록 하려면, sticky 옵션을 양수로 설정하시기 바랍니다. 테이블 시트의 열 머리글 행 수에 따라 고정 행 수가 자동으로 결정되므로 수동으로 고정 행 수를 지정할 필요가 없습니다.


다음 샘플 코드는 고정 헤더가 있는 테이블 시트를 표시하는 예시입니다:

var options = { sticky: { top: 1 } };
sheet.dataRanges.add(dataRangeName, tableSheetName, new GC.Spread.Sheets.Range(dataRangeStartRow, dataRangeStartCol, -1, -1), options);

참고: 고정 행(pinned rows)은 고정 헤더(sticky headers)에 포함되지 않습니다.

테이블 시트 데이터 범위의 정책

테이블 시트를 데이터 범위로 사용할 때는 다음과 같은 정책이 적용됩니다:

  • 데이터 범위에 대해:

    • 테이블 시트 데이터 범위의 크기는 자동으로 증가하거나 감소합니다.

    • range.rowCountrange.colCount 속성은 무시됩니다.

    • 테이블 시트에서 숨겨진 열과 행은 데이터 범위에 표시되지 않습니다.

    • 워크시트 내에서 표시할 수 있는 최대 행과 열 수를 항상 표시합니다.


  • Excel로 내보내기에 대해:

    • 테이블 시트 데이터 범위는 Excel에서 테이블로 내보내집니다.

    • 테이블 시트 행 머리글의 모서리와 모든 열은 잘려서(clipped) 표시됩니다.

    • 테이블 시트에 머리글 행이 여러 개 있는 경우, 마지막 행만 병합 없이 내보내집니다.

    • 아웃라인 그룹 레이아웃은 축소된 그룹 레이아웃으로 내보내집니다.

제한 사항

데이터 범위에서는 다음의 테이블 시트 기능이 지원되지 않습니다:

  • 자유 헤더 영역

  • 누적 열 헤더와 같은 열 머리글 맞춤 모드.

  • 특정 사용자 정의 속성 또는 동작이 정의된 열.