Quản lý series dữ liệu biểu đồ trong bài thuyết trình bằng Java

Tổng quan

Bài viết này mô tả vai trò của ChartSeries trong Aspose.Slides, tập trung vào cách dữ liệu được cấu trúc và hiển thị trong các bài thuyết trình. Các đối tượng này cung cấp các yếu tố nền tảng để xác định các tập hợp điểm dữ liệu, danh mục và tham số hiển thị riêng lẻ trong một biểu đồ. Khi làm việc với ChartSeries, các nhà phát triển có thể tích hợp liền mạch các nguồn dữ liệu cơ bản và duy trì kiểm soát đầy đủ về cách thông tin được trình bày, tạo ra các bài thuyết trình động, dựa trên dữ liệu, truyền tải rõ ràng những phân tích và hiểu biết.

Một series là một hàng hoặc cột các số được vẽ trên biểu đồ.

chart-series-powerpoint

Đặt chồng lấp Series biểu đồ

Với thuộc tính IChartSeriesOverlap, bạn có thể chỉ định mức độ chồng lấp của các thanh và cột trên biểu đồ 2D (phạm vi: -100 đến 100). Thuộc tính này áp dụng cho tất cả các series trong nhóm series cha: đây là một phép chiếu của thuộc tính nhóm tương ứng. Do đó, thuộc tính này chỉ đọc.

Sử dụng thuộc tính ParentSeriesGroup.Overlap đọc/ghi để đặt giá trị mong muốn cho Overlap.

Tạo một thể hiện của lớp Presentation.
Thêm một biểu đồ cột nhóm trên một slide.
Truy cập series đầu tiên của biểu đồ.
Truy cập ParentSeriesGroup của series và đặt giá trị chồng lấp mong muốn cho series.
Ghi bản trình bày đã chỉnh sửa ra file PPTX.

Đoạn mã Java sau cho thấy cách đặt chồng lấp cho một series biểu đồ:

Presentation pres = new Presentation();
try {
    // Thêm biểu đồ
    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)
    {
        // Đặt độ chồng lấp series
        series.get_Item(0).getParentSeriesGroup().setOverlap((byte)-30);
    }

    // Ghi file bài thuyết trình ra đĩa
    pres.save("SetChartSeriesOverlap_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Thay đổi màu Series

Aspose.Slides for Java cho phép bạn thay đổi màu của một series theo cách sau:

Tạo một thể hiện của lớp Presentation.
Thêm biểu đồ trên slide.
Truy cập series mà bạn muốn thay đổi màu.
Đặt kiểu tô và màu tô mong muốn.
Lưu bản trình bày đã chỉnh sửa.

Đoạn mã Java sau cho thấy cách thay đổi màu của một series:

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();
}

Thay đổi màu danh mục Series

Aspose.Slides for Java cho phép bạn thay đổi màu danh mục của một series theo cách sau:

Tạo một thể hiện của lớp Presentation.
Thêm biểu đồ trên slide.
Truy cập danh mục của series mà bạn muốn thay đổi màu.
Đặt kiểu tô và màu tô mong muốn.
Lưu bản trình bày đã chỉnh sửa.

Đoạn mã Java sau cho thấy cách thay đổi màu danh mục của một series:

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();
}

Thay đổi tên Series

Theo mặc định, tên chú giải cho một biểu đồ là nội dung của các ô phía trên mỗi cột hoặc hàng dữ liệu.

Trong ví dụ của chúng tôi (hình mẫu),

các cột là Series 1, Series 2, và Series 3;
các hàng là Category 1, Category 2, Category 3, và Category 4.

Aspose.Slides for Java cho phép bạn cập nhật hoặc thay đổi tên series trong dữ liệu biểu đồ và chú giải của nó.

Đoạn mã Java sau cho thấy cách thay đổi tên series trong ChartDataWorkbook của dữ liệu biểu đồ:

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();
}

Đoạn mã Java sau cho thấy cách thay đổi tên series trong chú giải thông qua 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();
}

Đặt màu tô tự động cho Series biểu đồ

Aspose.Slides for Java cho phép bạn đặt màu tô tự động cho series biểu đồ trong vùng vẽ biểu đồ theo cách sau:

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu của slide theo chỉ mục.
Thêm một biểu đồ với dữ liệu mặc định dựa trên loại bạn muốn (trong ví dụ dưới, chúng tôi sử dụng ChartType.ClusteredColumn).
Truy cập series biểu đồ và đặt màu tô thành Automatic.
Lưu bản trình bày ra file PPTX.

Đoạn mã Java sau cho thấy cách đặt màu tô tự động cho một series biểu đồ:

Presentation pres = new Presentation();
try {
    // Tạo biểu đồ cột nhóm
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 50, 600, 400);

    // Đặt định dạng tô màu series thành tự động
    for (int i = 0; i < chart.getChartData().getSeries().size(); i++)
    {
        chart.getChartData().getSeries().get_Item(i).getAutomaticSeriesColor();
    }

    // Ghi file bài thuyết trình ra đĩa
    pres.save("AutoFillSeries_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Đặt màu tô đảo ngược cho Series biểu đồ

Aspose.Slides cho phép bạn đặt màu tô đảo ngược cho series biểu đồ trong vùng vẽ biểu đồ theo cách sau:

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu của slide theo chỉ mục.
Thêm một biểu đồ với dữ liệu mặc định dựa trên loại bạn muốn (trong ví dụ dưới, chúng tôi sử dụng ChartType.ClusteredColumn).
Truy cập series biểu đồ và đặt màu tô thành invert.
Lưu bản trình bày ra file PPTX.

Đoạn mã Java thể hiện thao tác này:

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();

    // Thêm series và danh mục mới
    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"));

    // Lấy series biểu đồ đầu tiên và điền dữ liệu cho series đó.
    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();
}

Đặt series đảo ngược khi giá trị là âm

Aspose.Slides cho phép bạn thiết lập đảo ngược qua các thuộc tính IChartDataPoint.InvertIfNegative và ChartDataPoint.InvertIfNegative. Khi một series được đặt đảo ngược bằng các thuộc tính này, điểm dữ liệu sẽ đổi màu khi nhận giá trị âm.

Đoạn mã Java thể hiện thao tác này:

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();
}

Xóa dữ liệu điểm cụ thể

Aspose.Slides for Java cho phép bạn xóa dữ liệu DataPoints cho một series biểu đồ cụ thể theo cách sau:

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu của slide theo chỉ mục.
Lấy tham chiếu của biểu đồ theo chỉ mục.
Duyệt qua tất cả DataPoints của biểu đồ và đặt XValue và YValue thành null.
Xóa toàn bộ DataPoints cho series biểu đồ cụ thể.
Ghi bản trình bày đã chỉnh sửa ra file PPTX.

Đoạn mã Java thể hiện thao tác này:

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();
}

Đặt độ rộng khe cho Series

Aspose.Slides for Java cho phép bạn đặt độ rộng khe của một series qua thuộc tính GapWidth theo cách sau:

Tạo một thể hiện của lớp Presentation.
Truy cập slide đầu tiên.
Thêm biểu đồ với dữ liệu mặc định.
Truy cập bất kỳ series nào của biểu đồ.
Đặt thuộc tính GapWidth.
Ghi bản trình bày đã chỉnh sửa ra file PPTX.

Đoạn mã Java sau cho thấy cách đặt độ rộng khe cho một series:

// Tạo bài thuyết trình trống 
Presentation pres = new Presentation();
try {
    // Truy cập slide đầu tiên của bài thuyết trình
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Thêm biểu đồ với dữ liệu mặc định
    IChart chart = slide.getShapes().addChart(ChartType.StackedColumn, 0, 0, 500, 500);
    
    // Đặt chỉ số của bảng dữ liệu biểu đồ
    int defaultWorksheetIndex = 0;
    
    // Lấy bảng dữ liệu biểu đồ
    IChartDataWorkbook fact = chart.getChartData().getChartDataWorkbook();
    
    // Thêm series
    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());
    
    // Thêm danh mục
    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"));
    
    // Lấy series biểu đồ thứ hai
    IChartSeries series = chart.getChartData().getSeries().get_Item(1);
    
    // Điền dữ liệu cho series
    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));
    
    // Đặt giá trị GapWidth
    series.getParentSeriesGroup().setGapWidth(50);
    
    // Lưu bài thuyết trình ra đĩa
    pres.save("GapWidth_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Câu hỏi thường gặp

Có giới hạn về số lượng series mà một biểu đồ đơn có thể chứa không?

Aspose.Slides không đặt giới hạn cố định nào cho số lượng series bạn thêm. Giới hạn thực tế phụ thuộc vào khả năng đọc biểu đồ và bộ nhớ sẵn có cho ứng dụng của bạn.

Nếu các cột trong một nhóm quá gần nhau hoặc quá xa nhau thì sao?

Điều chỉnh thiết lập GapWidth cho series đó (hoặc nhóm series cha). Tăng giá trị sẽ làm rộng khoảng cách giữa các cột, giảm giá trị sẽ làm chúng gần nhau hơn.