Tùy chỉnh thanh lỗi trong biểu đồ trình chiếu bằng Java

Tổng quan

Bài viết này giải thích cách làm việc với thanh lỗi trong biểu đồ trình chiếu bằng cách sử dụng Aspose.Slides. Nó cho thấy cách thêm thanh lỗi vào một chuỗi biểu đồ, cấu hình các thiết lập thanh lỗi X và Y, và áp dụng các kiểu giá trị khác nhau như cố định, phần trăm và giá trị tùy chỉnh.

Nó cũng minh họa cách chỉ định các giá trị thanh lỗi tùy chỉnh cho các điểm dữ liệu cá nhân trong một chuỗi bằng cách sử dụng bộ sưu tập điểm dữ liệu tương ứng. Ngoài ra, bài viết bao gồm một số ghi chú ngắn về cách thanh lỗi hoạt động khi xuất, khả năng tương thích của chúng với các dấu đánh dấu và nhãn dữ liệu, và nơi tìm các lớp và enum tham chiếu API liên quan.

Thêm Thanh Lỗi

Aspose.Slides for Java cung cấp một API đơn giản để quản lý các giá trị thanh lỗi. Mã mẫu áp dụng khi sử dụng kiểu giá trị tùy chỉnh. Để chỉ định một giá trị, sử dụng thuộc tính ErrorBarCustomValues của một điểm dữ liệu cụ thể trong bộ sưu tập DataPoints của chuỗi:

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

// Tạo một thể hiện của lớp Presentation
Presentation pres = new Presentation();
try {
    // Tạo biểu đồ bong bóng
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Thêm thanh lỗi và thiết lập định dạng của chúng
    IErrorBarsFormat errBarX = chart.getChartData().getSeries().get_Item(0).getErrorBarsXFormat();
    IErrorBarsFormat errBarY = chart.getChartData().getSeries().get_Item(0).getErrorBarsYFormat();

    errBarX.isVisible();
    errBarY.isVisible();
    errBarX.setValueType((byte) ErrorBarValueType.Fixed);
    errBarX.setValue(0.1f);
    errBarY.setValueType((byte) ErrorBarValueType.Percentage);
    errBarY.setValue(5);
    errBarX.setType((byte) ErrorBarType.Plus);
    errBarY.getFormat().getLine().setWidth(2.0f);
    errBarX.hasEndCap();

    // Lưu bản trình chiếu
    pres.save("ErrorBars.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Thêm Giá Trị Thanh Lỗi Tùy Chỉnh

Aspose.Slides for Java cung cấp một API đơn giản để quản lý các giá trị thanh lỗi tùy chỉnh. Mã mẫu áp dụng khi thuộc tính IErrorBarsFormat.ValueType bằng Custom. Để chỉ định một giá trị, sử dụng thuộc tính ErrorBarCustomValues của một điểm dữ liệu cụ thể trong bộ sưu tập DataPoints của chuỗi:

Tạo một thể hiện của lớp Presentation.
Thêm một biểu đồ bong bóng vào slide mong muốn.
Truy cập chuỗi biểu đồ đầu tiên và đặt định dạng thanh lỗi X.
Truy cập chuỗi biểu đồ đầu tiên và đặt định dạng thanh lỗi Y.
Truy cập các điểm dữ liệu riêng lẻ của chuỗi biểu đồ và đặt giá trị Thanh Lỗi cho từng điểm dữ liệu.
Đặt giá trị và định dạng cho các thanh.
Ghi bản trình bày đã chỉnh sửa ra tệp PPTX.

// Tạo một thể hiện của lớp Presentation
Presentation pres = new Presentation();
try {
    // Tạo biểu đồ bong bóng
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Thêm thanh lỗi tùy chỉnh và thiết lập định dạng của chúng
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);
    IErrorBarsFormat errBarX = series.getErrorBarsXFormat();
    IErrorBarsFormat errBarY = series.getErrorBarsYFormat();
    errBarX.isVisible();
    errBarY.isVisible();
    errBarX.setValueType((byte) ErrorBarValueType.Custom);
    errBarY.setValueType((byte) ErrorBarValueType.Custom);

    // Truy cập điểm dữ liệu của chuỗi biểu đồ và thiết lập giá trị thanh lỗi cho
    // điểm riêng lẻ
    IChartDataPointCollection points = series.getDataPoints();
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForXPlusValues((byte) DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForXMinusValues((byte) DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForYPlusValues((byte) DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForYMinusValues((byte) DataSourceType.DoubleLiterals);

    // Thiết lập thanh lỗi cho các điểm của chuỗi biểu đồ
    for (int i = 0; i < points.size(); i++) {
        points.get_Item(i).getErrorBarsCustomValues().getXMinus().setAsLiteralDouble(i + 1);
        points.get_Item(i).getErrorBarsCustomValues().getXPlus().setAsLiteralDouble(i + 1);
        points.get_Item(i).getErrorBarsCustomValues().getYMinus().setAsLiteralDouble(i + 1);
        points.get_Item(i).getErrorBarsCustomValues().getYPlus().setAsLiteralDouble(i + 1);
    }

    // Lưu bản trình chiếu
    pres.save("ErrorBarsCustomValues.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

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

Điều gì xảy ra với thanh lỗi khi xuất bản trình chiếu sang PDF hoặc hình ảnh?

Chúng được vẽ như một phần của biểu đồ và được giữ nguyên trong quá trình chuyển đổi cùng với phần còn lại của định dạng biểu đồ, giả sử phiên bản hoặc bộ render tương thích.

Thanh lỗi có thể kết hợp với dấu đánh dấu và nhãn dữ liệu không?

Có. Thanh lỗi là một yếu tố riêng biệt và tương thích với dấu đánh dấu và nhãn dữ liệu; nếu các yếu tố chồng lên nhau, bạn có thể cần điều chỉnh định dạng.

Tôi có thể tìm danh sách các thuộc tính và lớp để làm việc với thanh lỗi trong API ở đâu?

Trong tài liệu API: lớp ErrorBarsFormat và các lớp liên quan ErrorBarType và ErrorBarValueType.