Управление данными серий диаграмм в презентациях на Android

Серия — это строка или столбец чисел, отображаемый на диаграмме.

chart-series-powerpoint

Установить перекрытие серии диаграммы

С помощью метода IChartSeries.getOverlap можно определить, насколько столбцы и бары должны перекрываться на 2D‑диаграмме (диапазон: –100 … 100). Это свойство применяется ко всем сериям родительской группы серий: это проекция соответствующего свойства группы. Поэтому свойство доступно только для чтения.

Используйте метод записи getParentSeriesGroup().setOverlap() для задания желаемого значения перекрытия.

Создайте экземпляр класса Presentation.
Добавьте на слайд кластеризованную столбчатую диаграмму.
Получите первую серию диаграммы.
Получите ParentSeriesGroup серии диаграммы и задайте нужное значение перекрытия.
Запишите изменённую презентацию в файл PPTX.

Этот код Java демонстрирует, как установить перекрытие для серии диаграммы:

Presentation pres = new Presentation();
try {
    // Добавляет диаграмму
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400, true);
    IChartSeriesCollection series = chart.getChartData().getSeries();
    if (series.get_Item(0).getOverlap() == 0)
    {
        // Устанавливает перекрытие серии
        series.get_Item(0).getParentSeriesGroup().setOverlap((byte)-30);
    }

    // Записывает файл презентации на диск
    pres.save("SetChartSeriesOverlap_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Изменить цвет серии

Aspose.Slides для Android через Java позволяет изменить цвет серии следующим способом:

Создайте экземпляр класса Presentation.
Добавьте на слайд диаграмму.
Получите серию, цвет которой требуется изменить.
Установите желаемый тип заливки и цвет заливки.
Сохраните изменённую презентацию.

Этот код Java показывает, как изменить цвет серии:

Presentation pres = new Presentation("test.pptx");
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Pie, 50, 50, 600, 400);
    IChartDataPoint point = chart.getChartData().getSeries().get_Item(0).getDataPoints().get_Item(1);

    point.setExplosion(30);
    point.getFormat().getFill().setFillType(FillType.Solid);
    point.getFormat().getFill().getSolidFillColor().setColor(Color.BLUE);

    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Изменить цвет категории серии

Aspose.Slides для Android через Java позволяет изменить цвет категории серии следующим образом:

Создайте экземпляр класса Presentation.
Добавьте на слайд диаграмму.
Получите категорию серии, цвет которой требуется изменить.
Установите желаемый тип заливки и цвет заливки.
Сохраните изменённую презентацию.

Этот код Java демонстрирует, как изменить цвет категории серии:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
    IChartDataPoint point = chart.getChartData().getSeries().get_Item(0).getDataPoints().get_Item(0);

    point.getFormat().getFill().setFillType(FillType.Solid);
    point.getFormat().getFill().getSolidFillColor().setColor(Color.BLUE);

    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Изменить имя серии

По умолчанию имена в легенде диаграммы берутся из ячеек, расположенных сверху над каждым столбцом или строкой данных.

В нашем примере (см. изображение)

столбцы — Series 1, Series 2 и Series 3;
строки — Category 1, Category 2, Category 3 и Category 4.

Aspose.Slides для Android через Java позволяет обновлять или изменять имя серии в данных диаграммы и в легенде.

Этот код Java показывает, как изменить имя серии в данных диаграммы ChartDataWorkbook:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Column3D, 50, 50, 600, 400, true);

    IChartDataCell seriesCell = chart.getChartData().getChartDataWorkbook().getCell(0, 0, 1);
    seriesCell.setValue("New name");

    pres.save("pres.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Этот код Java показывает, как изменить имя серии в легенде через Series:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Column3D, 50, 50, 600, 400, true);
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);

    IStringChartValue name = series.getName();
    name.getAsCells().get_Item(0).setValue("New name");
} finally {
    if (pres != null) pres.dispose();
}

Установить цвет заливки серии диаграммы

Aspose.Slides для Android через Java позволяет задать автоматический цвет заливки серии диаграммы в области построения следующим образом:

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Добавьте диаграмму с данными по умолчанию, используя требуемый тип (в примере ниже использовался ChartType.ClusteredColumn).
Получите серию диаграммы и задайте цвет заливки — Automatic.
Сохраните презентацию в файл PPTX.

Этот код Java демонстрирует, как задать автоматический цвет заливки серии диаграммы:

Presentation pres = new Presentation();
try {
    // Создает сгруппированную столбчатую диаграмму
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 50, 600, 400);

    // Устанавливает автоматический формат заливки серии
    for (int i = 0; i < chart.getChartData().getSeries().size(); i++)
    {
        chart.getChartData().getSeries().get_Item(i).getAutomaticSeriesColor();
    }

    // Записывает файл презентации на диск
    pres.save("AutoFillSeries_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Установить инвертированный цвет заливки для серии диаграммы

Aspose.Slides позволяет установить инвертированный цвет заливки серии диаграммы в области построения следующим способом:

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Добавьте диаграмму с данными по умолчанию, используя требуемый тип (в примере ниже использовался ChartType.ClusteredColumn).
Получите серию диаграммы и задайте цвет заливки — Invert.
Сохраните презентацию в файл PPTX.

Этот код Java демонстрирует операцию:

Color inverColor = Color.RED;
Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 100, 400, 300);
    IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook();

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();

    // Добавляет новые серии и категории
    chart.getChartData().getSeries().add(workBook.getCell(0, 0, 1, "Series 1"), chart.getType());
    chart.getChartData().getCategories().add(workBook.getCell(0, 1, 0, "Category 1"));
    chart.getChartData().getCategories().add(workBook.getCell(0, 2, 0, "Category 2"));
    chart.getChartData().getCategories().add(workBook.getCell(0, 3, 0, "Category 3"));

    // Берёт первую серию диаграммы и заполняет её данными серии.
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);
    series.getDataPoints().addDataPointForBarSeries(workBook.getCell(0, 1, 1, -20));
    series.getDataPoints().addDataPointForBarSeries(workBook.getCell(0, 2, 1, 50));
    series.getDataPoints().addDataPointForBarSeries(workBook.getCell(0, 3, 1, -30));
    Color seriesColor = series.getAutomaticSeriesColor();
    series.setInvertIfNegative(true);
    series.getFormat().getFill().setFillType(FillType.Solid);
    series.getFormat().getFill().getSolidFillColor().setColor(seriesColor);
    series.getInvertedSolidFillColor().setColor(inverColor);
    
    pres.save("SetInvertFillColorChart_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Сделать серию инвертируемой при отрицательном значении

Aspose.Slides позволяет задавать инверсию через свойства IChartDataPoint.InvertIfNegative и ChartDataPoint.InvertIfNegative. При установке инверсии через эти свойства точка данных меняет цвета, когда получает отрицательное значение.

Этот код Java демонстрирует операцию:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400, true);
    IChartSeriesCollection series = chart.getChartData().getSeries();
    chart.getChartData().getSeries().clear();

    IChartSeries chartSeries = series.add(chart.getChartData().getChartDataWorkbook().getCell(0, "B1"), chart.getType());
    chartSeries.getDataPoints().addDataPointForBarSeries(chart.getChartData().getChartDataWorkbook().getCell(0, "B2", -5));
    chartSeries.getDataPoints().addDataPointForBarSeries(chart.getChartData().getChartDataWorkbook().getCell(0, "B3", 3));
    chartSeries.getDataPoints().addDataPointForBarSeries(chart.getChartData().getChartDataWorkbook().getCell(0, "B4", -2));
    chartSeries.getDataPoints().addDataPointForBarSeries(chart.getChartData().getChartDataWorkbook().getCell(0, "B5", 1));

    chartSeries.setInvertIfNegative(false);

    chartSeries.getDataPoints().get_Item(2).setInvertIfNegative(true);

    pres.save("out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Очистить данные конкретной точки

Aspose.Slides для Android через Java позволяет очистить данные DataPoints конкретной серии диаграммы следующим способом:

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Получите ссылку на диаграмму по её индексу.
Пройдитесь по всем DataPoints диаграммы и задайте XValue и YValue значение null.
Очистите все DataPoints для конкретной серии диаграммы.
Запишите изменённую презентацию в файл PPTX.

Этот код Java демонстрирует операцию:

Presentation pres = new Presentation("TestChart.pptx");
try {
    ISlide sl = pres.getSlides().get_Item(0);

    IChart chart = (IChart)sl.getShapes().get_Item(0);

    for (IChartDataPoint dataPoint : chart.getChartData().getSeries().get_Item(0).getDataPoints())
    {
        dataPoint.getXValue().getAsCell().setValue(null);
        dataPoint.getYValue().getAsCell().setValue(null);
    }

    chart.getChartData().getSeries().get_Item(0).getDataPoints().clear();

    pres.save("ClearSpecificChartSeriesDataPointsData.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Установить ширину промежутка серии

Aspose.Slides для Android через Java позволяет задать ширину промежутка серии через свойство GapWidth следующим образом:

Создайте экземпляр класса Presentation.
Перейдите к первому слайду.
Добавьте диаграмму с данными по умолчанию.
Получите любую серию диаграммы.
Задайте свойство GapWidth.
Запишите изменённую презентацию в файл PPTX.

Этот код Java показывает, как установить ширину промежутка серии:

// Создает пустую презентацию 
Presentation pres = new Presentation();
try {
    // Получает первый слайд презентации
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Добавляет диаграмму с данными по умолчанию
    IChart chart = slide.getShapes().addChart(ChartType.StackedColumn, 0, 0, 500, 500);
    
    // Устанавливает индекс листа данных диаграммы
    int defaultWorksheetIndex = 0;
    
    // Получает лист данных диаграммы
    IChartDataWorkbook fact = chart.getChartData().getChartDataWorkbook();
    
    // Добавляет серии
    chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.getType());
    chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.getType());
    
    // Добавляет категории
    chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 1, 0, "Caetegoty 1"));
    chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 2, 0, "Caetegoty 2"));
    chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 3, 0, "Caetegoty 3"));
    
    // Берет вторую серию диаграммы
    IChartSeries series = chart.getChartData().getSeries().get_Item(1);
    
    // Заполняет данные серии
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 1, 20));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 1, 50));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 1, 30));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 2, 30));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 2, 10));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 2, 60));
    
    // Устанавливает значение GapWidth
    series.getParentSeriesGroup().setGapWidth(50);
    
    // Сохраняет презентацию на диск
    pres.save("GapWidth_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Существует ли ограничение на количество серий в одной диаграмме?

Aspose.Slides не накладывает фиксированного ограничения на количество добавляемых серий. Практический предел определяется читаемостью диаграммы и доступной памяти приложения.

Что делать, если столбцы внутри кластера расположены слишком близко или слишком далеко друг от друга?

Отрегулируйте параметр GapWidth для этой серии (или её родительской группы серий). Увеличение значения расширяет пространство между столбцами, уменьшение – сужает его.