Android 프레젠테이션에서 차트 데이터 시리즈 관리

이 페이지의 내용

Android 프레젠테이션에서 차트 시리즈, 데이터 포인트, 워크북 셀, 서식 지정, 겹침, 간격 폭 및 음수 값을 관리하는 방법을 배우세요.

개요

차트는 플롯된 데이터를 차트 데이터 워크북에 저장합니다. IChartSeries는 관련 값 집합을 나타내며, 시리즈의 각 IChartDataPoint은 하나 이상의 워크북 셀을 참조합니다. IChartCategory 객체는 시리즈가 공유하는 레이블 또는 그룹화 값을 제공합니다. 따라서 시리즈 이름, 범주 및 포인트 값은 표시 텍스트로만 저장되는 것이 아니라 IChartDataCell 객체와 연결됩니다.

일반적인 범주형 차트의 경우, 기본 워크북은 행 0을 시리즈 이름에, 열 0을 범주 이름에, 나머지 셀을 시리즈 값에 사용합니다. IChartDataWorkbook.getCell에 전달되는 워크시트, 행 및 열 인덱스는 0부터 시작합니다. 이 레이아웃은 기본 데이터를 사용해 차트를 만들 때 유용하지만, 모든 기존 차트가 이를 사용한다고 가정하지 마세요. 로드된 프레젠테이션에서는 워크북 값을 변경하기 전에 시리즈, 범주 및 데이터 포인트가 참조하는 셀을 확인하십시오.

차트 설정에는 세 가지 범위가 있습니다:

• 시리즈 수준 설정인 IChartSeries.getFormat은 하나의 시리즈에 속한 모든 포인트의 기본 모양을 제공합니다.
• 데이터 포인트 수준 설정인 IChartDataPoint.getFormat은 하나의 포인트에 대해 시리즈 모양을 재정의합니다.
• 그룹 설정은 동일한 IChartSeriesGroup에 속한 호환 시리즈에 적용됩니다. 겹침(overlap)이나 간격(gap width)과 같은 옵션을 설정해야 할 때는 IChartSeries.getParentSeriesGroup를 통해 그룹에 접근하십시오.

명시적인 포인트 또는 시리즈 채우기가 설정되지 않은 경우 차트 스타일과 테마가 자동 모양을 결정합니다. 시리즈와 포인트 서식이 모두 존재하면 해당 포인트에 대해 포인트 서식이 우선합니다.

차트 시리즈 겹침 설정

IChartSeries.getOverlap은 2D 차트에서 막대나 열이 얼마나 겹치는지를 -100부터 100 퍼센트까지 보고합니다. 이는 상위 시리즈 그룹에 대한 설정을 읽기 전용으로 투영한 값입니다. 해당 그룹의 모든 호환 시리즈를 업데이트하려면 IChartSeriesGroup.setOverlap를 사용하십시오. 이 옵션은 그룹화된 막대 또는 열을 표시하는 차트 유형에 적용되며, 조합 차트에서 관련 없는 시리즈 그룹에는 영향을 주지 않습니다.

다음 예제는 첫 번째 시리즈가 포함된 그룹의 겹침을 설정합니다:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final byte overlapPercent = 30;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    // 새 차트에는 샘플 시리즈, 범주 및 값이 포함되어 있습니다.
    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getParentSeriesGroup().setOverlap(overlapPercent);

    presentation.save("series_overlap.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

결과:

시리즈 채우기 색상 변경

IChartSeries.getFormat을 사용하여 전체 시리즈의 기본 채우기를 설정합니다. 포인트에 명시적인 채우기가 이미 지정되어 있으면 해당 포인트의 IChartDataPoint.getFormat 설정이 시리즈 채우기를 재정의합니다.

다음 예제는 첫 번째 시리즈에 단색 파란색 채우기를 적용합니다:

import com.aspose.slides.*;
import android.graphics.Color;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getFormat().getFill().setFillType(FillType.Solid);
    series.getFormat().getFill().getSolidFillColor().setColor(Color.BLUE);

    presentation.save("series_color.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

결과:

시리즈 이름 변경

시리즈 이름은 차트 데이터 워크북에 저장되며 일반적으로 범례에 표시됩니다. 클러스터드 컬럼 차트용 기본 워크북에서는 셀 B1이 행 0, 열 1에 위치하고 첫 번째 시리즈의 이름을 포함합니다. 아래 예제의 명명된 상수는 해당 구조를 명시적으로 나타냅니다:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int worksheetIndex = 0;
final int seriesNameRowIndex = 0;
final int firstSeriesColumnIndex = 1;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    IChartDataCell seriesNameCell = workbook.getCell(worksheetIndex, seriesNameRowIndex, firstSeriesColumnIndex);
    seriesNameCell.setValue("Revenue");

    presentation.save("series_name.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

또는 IChartSeries.getName이 이미 참조하는 셀을 업데이트할 수도 있습니다. 이 접근 방식은 기존 차트에서 특정 행과 열을 가정하지 않도록 합니다:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int firstNameCellIndex = 0;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    IChartDataCell seriesNameCell = series.getName().getAsCells().get_Item(firstNameCellIndex);
    seriesNameCell.setValue("Revenue");

    presentation.save("series_name.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

결과:

자동 시리즈 채우기 색상 가져오기

IChartSeries.getAutomaticSeriesColor은 시리즈 인덱스와 차트 스타일을 기반으로 계산된 Android ARGB 색상 정수를 반환합니다. 이는 시리즈 채우기가 명시적으로 정의되지 않았을 때 사용되는 색상입니다. 메서드를 호출하면 계산된 색상이 반환될 뿐 새 채우기가 할당되지 않습니다.

다음 예제는 각 기본 시리즈의 자동 색상 정수를 출력합니다:

import com.aspose.slides.*;

final int firstSlideIndex = 0;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    int seriesCount = chart.getChartData().getSeries().size();
    for (int seriesIndex = 0; seriesIndex < seriesCount; seriesIndex++) {
        IChartSeries series = chart.getChartData().getSeries().get_Item(seriesIndex);
        int automaticColor = series.getAutomaticSeriesColor();
        System.out.println("Series " + seriesIndex + ": " + automaticColor);
    }
} finally {
    presentation.dispose();
}

정수 값은 차트 스타일 및 테마에 따라 달라집니다.

시리즈에 대해 반전 채우기 색상 설정

막대, 컬럼 및 버블 시리즈의 경우, IChartSeries.setInvertIfNegative를 사용하여 음수 값을 다른 채우기로 표시할 수 있습니다. 일반 시리즈 채우기를 단색으로 설정하고 반전을 활성화한 뒤, IChartSeries.getInvertedSolidFillColor을 통해 음수값 색상을 지정하십시오. 워크북의 음수값 자체는 변경되지 않으며, 표시 색상만 바뀝니다.

다음 예제는 기본 차트 데이터를 하나의 시리즈로 교체합니다. 워크시트 행 0은 시리즈 이름, 열 0은 범주 이름, 열 1은 값을 포함합니다:

import com.aspose.slides.*;
import android.graphics.Color;

final int firstSlideIndex = 0;
final int worksheetIndex = 0;
final int headerRowIndex = 0;
final int categoryColumnIndex = 0;
final int firstSeriesColumnIndex = 1;
final int firstDataRowIndex = 1;

String[] categoryNames = { "Category 1", "Category 2", "Category 3" };
int[] seriesValues = { -20, 50, -30 };

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
    IChartData chartData = chart.getChartData();
    IChartDataWorkbook workbook = chartData.getChartDataWorkbook();

    chartData.getSeries().clear();
    chartData.getCategories().clear();

    IChartDataCell seriesNameCell = workbook.getCell(worksheetIndex, headerRowIndex, firstSeriesColumnIndex, "Series 1");
    int chartType = chart.getType();
    IChartSeries series = chartData.getSeries().add(seriesNameCell, chartType);

    for (int categoryIndex = 0; categoryIndex < categoryNames.length; categoryIndex++) {
        int dataRowIndex = firstDataRowIndex + categoryIndex;
        String categoryName = categoryNames[categoryIndex];
        int seriesValue = seriesValues[categoryIndex];

        IChartDataCell categoryCell = workbook.getCell(worksheetIndex, dataRowIndex, categoryColumnIndex, categoryName);
        chartData.getCategories().add(categoryCell);

        IChartDataCell valueCell = workbook.getCell(worksheetIndex, dataRowIndex, firstSeriesColumnIndex, seriesValue);
        series.getDataPoints().addDataPointForBarSeries(valueCell);
    }

    int automaticSeriesColor = series.getAutomaticSeriesColor();
    series.getFormat().getFill().setFillType(FillType.Solid);
    series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
    series.setInvertIfNegative(true);
    series.getInvertedSolidFillColor().setColor(Color.RED);

    presentation.save("inverted_solid_fill_color.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

결과:

한 포인트에 대해서만 반전을 활성화하려면 IChartDataPoint.setInvertIfNegative를 사용하십시오. 아래 예제에서는 시리즈에 대한 반전을 비활성화하고 선택한 포인트에만 활성화합니다. 포인트에 음수 값을 할당해 효과를 확인할 수 있습니다:

import com.aspose.slides.*;
import android.graphics.Color;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int targetDataPointIndex = 2;
final int negativeValue = -30;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    int automaticSeriesColor = series.getAutomaticSeriesColor();
    series.getFormat().getFill().setFillType(FillType.Solid);
    series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
    series.getInvertedSolidFillColor().setColor(Color.RED);
    series.setInvertIfNegative(false);

    IChartDataPoint dataPoint = series.getDataPoints().get_Item(targetDataPointIndex);
    dataPoint.getValue().getAsCell().setValue(negativeValue);
    dataPoint.setInvertIfNegative(true);

    presentation.save("data_point_invert_color_if_negative.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

특정 데이터 포인트 값 지우기

다른 포인트를 제거하지 않고 하나의 포인트를 비우려면 해당 백업 워크북 셀을 null로 설정하십시오. 컬럼 차트의 경우 플롯된 값은 IChartDataPoint.getValue을 통해 얻을 수 있습니다. 데이터 포인트는 동일한 범주 위치에 남아 있지만 차트는 해당 값을 빈 값으로 처리합니다(차트의 빈값 설정에 따름).

다음 예제는 첫 번째 시리즈의 두 번째 포인트만 지웁니다:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int targetDataPointIndex = 1;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    IChartDataPoint dataPoint = series.getDataPoints().get_Item(targetDataPointIndex);
    dataPoint.getValue().getAsCell().setValue(null);

    presentation.save("clear_data_point_value.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

산점도는 X와 Y 셀을 별도로 사용하고, 버블 차트는 크기 셀도 사용합니다. 제거하려는 값에 해당하는 셀만 지우십시오. 다른 포인트를 유지하려면 IChartDataPointCollection.clear를 호출하지 마세요. 이 메서드는 해당 시리즈의 모든 데이터 포인트를 삭제합니다.

빈 셀 표시 제어

값이 있는 숨겨진 셀은 빈 셀과 별개의 경우입니다. 숨겨진 워크시트 행 및 열의 데이터를 포함하거나 제외하려면 숨겨진 행 및 열의 데이터 포함 을 참조하십시오.

빈 워크북 셀은 데이터가 없음을 나타내며, 0이 들어 있는 셀은 알려진 숫자 값을 나타냅니다. 셀을 비우려면 null을 사용해 IChartDataCell.setValue를 호출하십시오. 숫자 0은 빈 셀 설정에 관계없이 그대로 0으로 유지됩니다.

IChart.setDisplayBlanksAs를 사용해 차트가 빈 셀을 표시하는 방식을 선택하십시오. 이 설정은 전체 차트에 적용되며, 빈 셀을 0이나 보간값으로 채우지 않고 플롯 방식만 변경합니다.

다음 자체 포함 예제는 한 시리즈가 있는 라인 차트를 만들고, Day 3의 값을 지운 뒤 각 모드별로 차트를 저장합니다. 입력 파일이 필요하지 않습니다. IChartDataWorkbook은 워크시트 0, 열 0을 범주 레이블에, 열 1을 값에 사용하며, 행 0에 시리즈 이름을 둡니다. 최종 데이터는 10, 20, empty, 30, 40 입니다:

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.LineWithMarkers, 40, 40, 640, 400);
    IChartData chartData = chart.getChartData();
    IChartDataWorkbook workbook = chartData.getChartDataWorkbook();

    chartData.getSeries().clear();
    chartData.getCategories().clear();

    IChartDataCell seriesNameCell = workbook.getCell(0, 0, 1, "Measurements");
    IChartSeries series = chartData.getSeries().add(seriesNameCell, chart.getType());
    int[] values = { 10, 20, 25, 30, 40 };

    for (int i = 0; i < values.length; i++) {
        IChartDataCell categoryCell = workbook.getCell(0, i + 1, 0, "Day " + (i + 1));
        chartData.getCategories().add(categoryCell);
        IChartDataCell valueCell = workbook.getCell(0, i + 1, 1, values[i]);
        series.getDataPoints().addDataPointForLineSeries(valueCell);
    }

    // Day 3을 실제로 비워 두고, 해당 범주와 데이터 포인트는 유지합니다.
    workbook.getCell(0, 3, 1).setValue(null);

    int[] modes = { DisplayBlanksAsType.Gap, DisplayBlanksAsType.Zero, DisplayBlanksAsType.Span };
    String[] modeNames = { "Gap", "Zero", "Span" };
    for (int i = 0; i < modes.length; i++) {
        chart.setDisplayBlanksAs(modes[i]);
        presentation.save("empty_cells_" + modeNames[i] + ".pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

각 출력 파일은 저장 전에 지정된 모드를 이름에 포함합니다: empty_cells_Gap.pptx, empty_cells_Zero.pptx, empty_cells_Span.pptx. 하나의 버전만 저장하려면 원하는 모드만 설정하고 프레젠테이션을 한 번 저장하면 됩니다.

아래 비교는 세 파일 모두 동일한 데이터를 보여줍니다. Day 3은 모든 경우 워크북에서 비어 있습니다:

보이는 효과는 차트 유형에 따라 다릅니다. 라인 차트는 세 모드를 쉽게 비교할 수 있지만, 막대와 컬럼 차트는 누락된 범주를 연결할 선이 없으므로 Span이 위와 같은 연결 구간을 만들 수 없습니다. 누락된 컬럼과 0높이 컬럼도 비슷하게 보일 수 있습니다. 마커만 있는 산점도 역시 연결 선이 없으므로 모든 차트 유형에서 세 가지 뚜렷한 결과를 기대하지 말고, 사용 중인 차트 유형에 대한 출력을 확인하십시오.

시리즈 간격 폭 설정

간격 폭은 인접한 막대 또는 컬럼 클러스터 사이의 공간을 막대 또는 컬럼 폭의 백분율로 나타낸 것입니다. 겹침과 마찬가지로 이는 개별 시리즈가 아니라 상위 시리즈 그룹에 속합니다. 그룹에 대해 한 번만 IChartSeriesGroup.setGapWidth를 호출하십시오. 값이 클수록 클러스터 사이의 공간이 넓어지고, 값이 작을수록 더 촘촘해집니다.

다음 예제는 간격 폭을 변경하고 최종 프레젠테이션만 저장합니다:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int gapWidthPercent = 30;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.StackedColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getParentSeriesGroup().setGapWidth(gapWidthPercent);

    presentation.save("gap_width_30.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

결과:

FAQ

어떤 차트 유형이 데이터 시리즈를 지원합니까?

ChartType 열거형으로 표현되는 모든 차트 유형이 차트 데이터를 사용하지만, 각 시리즈가 동일한 값 구조나 설정을 갖는 것은 아닙니다. 예를 들어, 범주형 차트는 범주와 값을, 산점도는 X와 Y 값을, 버블 차트는 버블 크기를 사용합니다. 시리즈 유형에 맞는 데이터 포인트 생성 메서드를 사용하십시오. 겹침 및 간격 폭과 같은 옵션은 호환되는 막대 또는 컬럼 그룹에만 적용됩니다.

차트 시리즈 그룹이란 무엇입니까?

IChartSeriesGroup은 그룹 수준 플롯 설정을 공유하는 호환 시리즈를 포함합니다. 조합 차트는 하나 이상의 그룹을 가질 수 있으므로, 하나의 시리즈를 통해 접근한 그룹을 변경한다고 해서 차트의 모든 시리즈가 변경되는 것은 아닙니다.

새로 만든 차트에 기본 데이터가 포함되어 있습니까?

예. 기본적으로 IShapeCollection.addChart는 샘플 시리즈, 범주 및 값을 생성합니다. 이러한 셀을 편집하거나 완전히 사용자 정의된 데이터 세트를 추가하기 전에 시리즈와 범주 컬렉션을 모두 지울 수 있습니다. 오버로드를 사용하면 기본 데이터 없이 차트를 만들 수도 있습니다.

차트 객체는 워크북 셀과 어떻게 연결됩니까?

시리즈 이름, 범주 레이블 및 데이터 포인트 값은 IChartDataWorkbook의 셀을 참조합니다. 참조된 셀을 변경하면 해당 차트 요소가 업데이트됩니다. 사용자 정의 데이터를 구축할 때는 범주 행과 시리즈-값 행이 정렬되어 각 포인트가 의도한 범주 아래에 플롯되도록 하십시오.

전체 시리즈가 아닌 하나의 포인트만 지우려면 어떻게 합니까?

해당 값 셀을 null로 설정하면 포인트의 범주 위치는 유지되면서 빈 포인트가 됩니다. 전체 시리즈의 포인트를 모두 제거하려는 경우에만 IChartDataPointCollection.clear를 사용하십시오. 범주도 함께 제거한다면 모든 시리즈를 업데이트해 값이 범주 컬렉션과 일치하도록 해야 합니다.

빈 포인트는 어떻게 표시됩니까?

표시 방식은 차트 유형과 IChart.setDisplayBlanksAs에서 구성한 값에 따라 달라집니다. 지원되는 차트는 빈 포인트를 간격(gap), 0값 또는 인접 포인트 연결 방식으로 표시할 수 있습니다. 프레젠테이션에서 누락된 데이터의 의미에 맞는 설정을 선택하십시오. 전체 예제와 시각적 비교는 빈 셀 표시 제어 섹션을 참조하십시오.

음수 값은 어떻게 서식이 지정됩니까?

지원되는 막대, 컬럼 및 버블 시리즈에 대해 IChartSeries.setInvertIfNegative를 호출하고, IChartSeries.getInvertedSolidFillColor이 반환하는 색상을 설정하십시오. 개별 포인트에 대해서는 IChartDataPoint.setInvertIfNegative로 동작을 재정의할 수 있습니다. 이러한 메서드는 서식에만 영향을 미치며 저장된 숫자 값은 변하지 않습니다.

시리즈와 포인트 모두 서식이 지정된 경우 어느 것이 우선합니까?

명시적인 데이터 포인트 서식이 해당 포인트에 대해 우선합니다. 다른 포인트는 명시적인 시리즈 서식(또는 시리즈 서식이 정의되지 않은 경우 자동 차트 스타일 및 테마)을 사용합니다. 겹침 및 간격 폭과 같은 그룹 설정은 레이아웃을 제어하며, 포인트 수준 서식 재정의가 아닙니다.

차트에 포함할 수 있는 시리즈 수에 제한이 있습니까?

Aspose.Slides는 별도의 고정 시리즈 수 제한을 두지 않습니다. 실제 제한은 프레젠테이션 파일 크기, 사용 가능한 메모리, 렌더링 시간 및 차트 가독성 등에 따라 달라집니다.

컬럼이 너무 가깝거나 멀리 떨어져 있으면 어떻게 수정합니까?

해당 상위 시리즈 그룹에서 IChartSeriesGroup.setGapWidth를 호출하십시오. 값을 늘리면 클러스터 사이 간격이 넓어지고, 줄이면 클러스터가 더 가까워집니다.