在 Android 上管理簡報中的圖表資料系列

概觀

本文說明了 ChartSeries 在 Aspose.Slides 中的角色，重點在於資料於簡報中的結構與可視化方式。這些物件提供了定義圖表中單一資料點集合、類別與外觀參數的基礎要素。透過使用 ChartSeries，開發人員可以無縫整合底層資料來源，並完整掌控資訊的呈現方式，從而產生動態、資料驅動的簡報，清晰傳遞見解與分析。

系列是圖表中繪製的行或列的數字。

chart-series-powerpoint

設定圖表系列重疊

使用 IChartSeries.getOverlap 方法，您可以決定在 2D 圖表上柱狀或條形的重疊程度（範圍：-100 至 100）。此屬性適用於父系列群組的所有系列：它是相應群組屬性的投影。因此，此屬性為唯讀。

使用 getParentSeriesGroup().setOverlap() 寫入方法可設定您偏好的重疊值。

  1. 建立 Presentation 類別的實例。
  2. 在投影片上新增一個聚集柱狀圖。
  3. 存取第一個圖表系列。
  4. 存取圖表系列的 ParentSeriesGroup 並設定您偏好的系列重疊值。
  5. 將修改後的簡報寫入 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 for Android via Java 可讓您以以下方式變更系列的顏色：

  1. 建立 Presentation 類別的實例。
  2. 在投影片上新增圖表。
  3. 取得您想變更顏色的系列。
  4. 設定您偏好的填滿類型與填滿顏色。
  5. 儲存修改後的簡報。

下列 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 for Android via Java 可讓您以以下方式變更系列類別的顏色：

  1. 建立 Presentation 類別的實例。
  2. 在投影片上新增圖表。
  3. 取得您想變更顏色的系列類別。
  4. 設定您偏好的填滿類型與填滿顏色。
  5. 儲存修改後的簡報。

下列 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 for Android via 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 for Android via Java 可讓您以以下方式在繪圖區內設定圖表系列的自動填滿顏色：

  1. 建立 Presentation 類別的實例。
  2. 取得投影片的參考（依其索引）。
  3. 依您偏好的類型新增預設資料的圖表（以下範例使用 ChartType.ClusteredColumn）。
  4. 存取圖表系列並將填滿顏色設為 Automatic。
  5. 將簡報儲存為 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 可讓您以以下方式在繪圖區內設定圖表系列的反轉填滿顏色：

  1. 建立 Presentation 類別的實例。
  2. 取得投影片的參考（依其索引）。
  3. 依您偏好的類型新增預設資料的圖表（以下範例使用 ChartType.ClusteredColumn）。
  4. 存取圖表系列並將填滿顏色設為 invert。
  5. 將簡報儲存為 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 for Android via Java 可讓您以以下方式清除特定圖表系列的 DataPoints 資料：

  1. 建立 Presentation 類別的實例。
  2. 透過索引取得投影片的參考。
  3. 透過索引取得圖表的參考。
  4. 遍歷所有圖表的 DataPoints 並將 XValue 與 YValue 設為 null。
  5. 清除特定圖表系列的所有DataPoints。
  6. 將修改後的簡報寫入 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 for Android via Java 可讓您以以下方式透過 GapWidth 屬性設定系列的間隔寬度：

  1. 建立 Presentation 類別的實例。
  2. 存取第一張投影片。
  3. 新增具有預設資料的圖表。
  4. 存取任意圖表系列。
  5. 設定 GapWidth 屬性。
  6. 將修改後的簡報寫入 PPTX 檔案。

下列 Java 程式碼示範如何設定系列的 Gap Width：

// 建立空白簡報 
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();
}

常見問題

單一圖表可以包含的系列數量是否有限制？

Aspose.Slides 對您加入的系列數量沒有固定上限。實際的上限取決於圖表的可讀性以及應用程式可用的記憶體。

如果叢集內的柱狀圖太靠近或太分散，該怎麼辦？

調整該系列（或其父系列群組）的 GapWidth 設定。增大數值會拉寬柱狀之間的間距，減小數值則會使它們更靠近。