Working with Charts

차트 작업

Aspose.Cells FOSS for Java는 XLSX 워크북을 로드하고 저장할 때 삽입된 차트를 보존합니다. 기존 차트를 검사하고, 유형과 위치를 조회하며, 표준 유형 차트를 프로그래밍 방식으로 추가할 수 있습니다. ChartEx 유형인 Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, 그리고 Map은 라운드-트립 동안 보존되지만 API을 통해 생성할 수 없습니다.

개요

워크시트의 차트는 Worksheet.getCharts()을 통해 접근되는 ChartCollection를 통해 관리됩니다. 각 Chart 인스턴스는 이름, 차트 유형 및 두 셀 앵커 위치를 제공합니다. 새로운 차트는 ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn)으로 삽입되며, 이는 새로 생성된 차트의 인덱스를 반환합니다.

ChartType 열거형은 차트 변형(막대, 선, 파이 등)을 식별합니다. 헬퍼 메서드 ChartCollection.parseChartType(string)와 ChartCollection.chartTypeToString(ChartType)는 직렬화 상황에서 열거형과 문자열 표현 간의 변환을 수행합니다.

핵심 클래스

클래스	설명
`Chart`	워크시트에 삽입된 차트를 나타냅니다. 이름, 유형 및 셀 앵커 위치에 대한 읽기 전용 접근을 제공합니다.
`ChartCollection`	워크시트에 있는 모든 차트의 컬렉션입니다. 차트 개수, 인덱스 접근, 추가 및 차트 유형 변환 도우미를 지원합니다.
`ChartType`	차트 변형을 식별하는 열거형 (막대, 열, 선, 파이, 산점도 등).
`ChartModel`	차트에 대한 내부 직렬화 모델입니다. 로드/저장 시 사용되는 원시 XML 필드를 노출합니다.

워크시트에서 차트에 접근하기

Worksheet.getCharts()를 통해任意의 Worksheet 객체에서 ChartCollection를 가져옵니다. ChartCollection.getCount()을 사용하여 차트가 몇 개 있는지 확인합니다. 개별 차트는 ChartCollection.get(index)를 통해 0부터 시작하는 인덱스로 접근합니다.

한 번 Chart 참조를 보유하면 읽을 수 있습니다:

Chart.getName() — 차트의 내부 이름 문자열입니다.
Chart.getChartType() — ChartType 열거형 값입니다.
Chart.getUpperLeftRow() / Chart.getUpperLeftColumn() — 좌상단 기준 셀입니다.
Chart.getLowerRightRow() / Chart.getLowerRightColumn() — 우하단 기준 셀입니다.
Chart.getExtentCx() / Chart.getExtentCy() — EMU 단위의 차트 범위입니다.

새 차트 추가

새 차트를 삽입하려면 ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn)을(를) 사용하십시오. 이 메서드는 컬렉션 내 차트의 정수 인덱스를 반환합니다. type 인수에 ChartType 값을 제공하고, dataRange에 셀 범위 문자열(예: A1:B5)을 제공하십시오.

주의: ChartEx-family 유형(워터폴, 트리맵, 선버스트, 히스토그램, 박스 앤 위스커, 퍼널, 맵)은 XLSX 파일을 로드할 때 보존되지만 이 API을 통해 프로그래밍 방식으로 생성할 수 없습니다.

API Reference 요약

Chart

메서드	반환 타입	설명
`getName()`	`String`	차트의 내부 이름.
`getChartType()`	`ChartType`	차트 변형 열거형 값.
`getUpperLeftRow()`	`int`	좌상단 앵커의 행 인덱스.
`getUpperLeftColumn()`	`int`	좌상단 앵커의 열 인덱스.
`getLowerRightRow()`	`int`	우하단 앵커의 행 인덱스.
`getLowerRightColumn()`	`int`	오른쪽 하단 앵커의 열 인덱스.
`getExtentCx()`	`long`	EMU 단위 차트 너비.
`getExtentCy()`	`long`	EMU 단위 차트 높이.

ChartCollection

메서드	반환 타입	설명
`getCount()`	`int`	워크시트에 있는 차트 수.
`get(index)`	`Chart`	주어진 0 기반 인덱스에 해당하는 차트를 반환합니다.
`add(type, dataRange, ...)`	`int`	새 차트를 추가합니다; 인덱스를 반환합니다.
`parseChartType(string)`	`ChartType`	문자열 이름을 `ChartType` 열거형 값으로 변환합니다.
`chartTypeToString(type)`	`String`	`ChartType` 열거형 값을 문자열 이름으로 변환합니다.

제한 사항

ChartEx 유형(Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map)은 원본 그대로 라운드트립되지만 API를 통해 생성할 수 없습니다.
이 릴리스에서는 차트 데이터 시리즈 바인딩을 수정할 수 없습니다; 차트는 생성 시 제공된 원본 데이터 범위를 기반으로 렌더링됩니다.

참조

Aspose.Cells for Java — Enterprise Documentation