使用 Java 在簡報中自訂圓餅圖

本頁內容簡介

在 Java 中使用 Aspose.Slides 建立並自訂圓餅圖。設定次要圖表、顯示資料標籤，並在 PowerPoint 中套用自動切片顏色。

概述

本文說明如何在 Aspose.Slides 中使用圓餅圖。它展示了如何為「Pie of Pie」和「Bar of Pie」圖表配置次要圖表選項，以及如何為標準圓餅圖啟用自動切片著色。

範例著重於圖表自訂作業，例如將圖表加入投影片、調整序列與標籤設定、以自訂類別與數值取代預設圖表資料，以及儲存更新後的簡報。

Pie of Pie 與 Bar of Pie 圖表的次要圖表選項

Aspose.Slides for Java 支援 Pie of Pie 與 Bar of Pie 圖表的次要圖表選項。這些選項可控制次要圖表的大小以及資料點在兩個圖表之間的分割方式。

以下範例在新簡報中建立一個 Pie of Pie 圖表，並將資料點值顯示為標籤。setSecondPieSize 方法將次要圖表的大小設定為主圖表的 149%。setPieSplitBy 選擇以百分比方式分割，且 setPieSplitPosition 將門檻設定為 53%。

import com.aspose.slides.*;

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

    IChart chart = slide.getShapes().addChart(ChartType.PieOfPie, 50, 50, 500, 400);
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);

    // 顯示數值並設定次要圖表。
    series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
    IChartSeriesGroup seriesGroup = series.getParentSeriesGroup();
    seriesGroup.setSecondPieSize(149);
    seriesGroup.setPieSplitBy(PieSplitType.ByPercentage);
    seriesGroup.setPieSplitPosition(53);

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

選取次要圖表的類別

當您想在次要圖表中將特定類別分組，而不考慮其百分比值時，可以使用自訂分割。舉例來說，銷售報告可能會將線上 (Online) 與活動 (Events) 合併顯示，讓讀者能比較這兩個渠道，即使它們分別佔總銷售的 35% 與 10%。

呼叫 setPieSplitBy 並傳入 PieSplitType.Custom 以透過 getPieSplitCustomPoints 選取點。集合的 add 方法接受系列中的零基索引；使用 addItem 來新增資料點物件。在此範例中，索引 1 選取 Online，索引 3 的點選取 Events。Partners 亦暫時加入，然後使用 removeItem 移除。

import com.aspose.slides.*;

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

    IChart chart = slide.getShapes().addChart(ChartType.PieOfPie, 50, 50, 600, 200);

    // 將預設資料取代為各渠道的銷售。
    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();
    String[] categoryNames = { "Retail", "Online", "Partners", "Events" };
    int[] values = { 40, 35, 15, 10 };
    IChartDataCell seriesNameCell = workbook.getCell(0, 0, 1, "Sales");
    IChartSeries series = chart.getChartData().getSeries().add(seriesNameCell, chart.getType());

    for (int i = 0; i < categoryNames.length; i++) {
        IChartDataCell categoryCell = workbook.getCell(0, i + 1, 0, categoryNames[i]);
        chart.getChartData().getCategories().add(categoryCell);

        IChartDataCell valueCell = workbook.getCell(0, i + 1, 1, values[i]);
        series.getDataPoints().addDataPointForPieSeries(valueCell);
    }

    series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
    IChartSeriesGroup seriesGroup = series.getParentSeriesGroup();
    seriesGroup.setPieSplitBy(PieSplitType.Custom);
    seriesGroup.setColorVaried(true);

    // 以零基索引選取 Online，並以資料點物件選取 Events。
    seriesGroup.getPieSplitCustomPoints().add(1);
    seriesGroup.getPieSplitCustomPoints().addItem(series.getDataPoints().get_Item(3));

    // 從選取中排除 Partners，但不刪除其來源資料。
    seriesGroup.getPieSplitCustomPoints().add(2);
    seriesGroup.getPieSplitCustomPoints().removeItem(series.getDataPoints().get_Item(2));

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

Online（35）與 Events（10）在次要圖表中顯示為分別的切片。在主圖表中，它們以一個合併切片（值為 45）呈現，並與 Retail（40）和 Partners（15）一起。從自訂選取中移除 Partners 後，它仍保留在主圖表中；不會從圖表的來源資料中移除該類別或其數值。

下圖顯示在 PowerPoint 中儲存的簡報：

Pie of Pie 圖表，在次要圖表中顯示 Online 與 Events，且在主圖表中以合併值 45 顯示

設定自動圓餅圖切片顏色

Aspose.Slides for Java 可以自動為圓餅圖切片指派不同顏色。以下範例建立一個具有置中標題的圓餅圖，並以三個季別類別及其數值取代預設資料。setShowValue 方法將 20、50 與 30 的數值顯示為標籤，而 setColorVaried 則為每個切片啟用不同顏色。

import com.aspose.slides.*;

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

    IChart chart = slide.getShapes().addChart(ChartType.Pie, 100, 100, 400, 400);

    // 新增置中的圖表標題。
    chart.getChartTitle().addTextFrameForOverriding("Sample Title");
    chart.getChartTitle().getTextFrameForOverriding().getTextFrameFormat().setCenterText(NullableBool.True);
    chart.getChartTitle().setHeight(20);
    chart.setTitle(true);

    // 使用第一個工作表取代預設資料。
    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    int worksheetIndex = 0;
    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();
    String[] categoryNames = { "First Qtr", "2nd Qtr", "3rd Qtr" };
    int[] values = { 20, 50, 30 };
    IChartDataCell seriesNameCell = workbook.getCell(worksheetIndex, 0, 1, "Series 1");
    IChartSeries series = chart.getChartData().getSeries().add(seriesNameCell, chart.getType());

    for (int i = 0; i < categoryNames.length; i++) {
        IChartDataCell categoryCell = workbook.getCell(worksheetIndex, i + 1, 0, categoryNames[i]);
        chart.getChartData().getCategories().add(categoryCell);

        IChartDataCell valueCell = workbook.getCell(worksheetIndex, i + 1, 1, values[i]);
        series.getDataPoints().addDataPointForPieSeries(valueCell);
    }

    // 顯示數值並為切片指派不同顏色。
    series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
    series.getParentSeriesGroup().setColorVaried(true);

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

常見問題

是否支援 Pie of Pie 與 Bar of Pie 變體？

是的，該函式庫支援圓餅圖的次要圖表，包括 Pie of Pie 與 Bar of Pie 類型。

我可以只將圖表匯出為圖像（例如 PNG）嗎？

是的，您可以將圖表本身匯出為圖像（例如 PNG），而無需匯出整個簡報。

使用 Java 在簡報中自訂環形圖