ปรับแต่งแถบความคลาดเคลื่อนในแผนภูมิการนำเสนอด้วย JavaScript

ภาพรวม

บทความนี้อธิบายวิธีการทำงานกับแถบความคลาดเคลื่อนในแผนภูมิการนำเสนอโดยใช้ Aspose.Slides มันแสดงวิธีการเพิ่มแถบความคลาดเคลื่อนให้กับชุดข้อมูลในแผนภูมิ, กำหนดการตั้งค่าแถบความคลาดเคลื่อน X และ Y, และใช้ประเภทค่าต่าง ๆ เช่น ค่าคงที่, ร้อยละ, และค่าที่กำหนดเอง

นอกจากนี้ยังสาธิตวิธีการกำหนดค่าแถบความคลาดเคลื่อนแบบกำหนดเองสำหรับจุดข้อมูลแต่ละจุดในชุดข้อมูลโดยใช้คอลเลกชันจุดข้อมูลที่สอดคล้องกัน อีกทั้งบทความยังรวมบันทึกสั้น ๆ เกี่ยวกับพฤติกรรมของแถบความคลาดเคลื่อนระหว่างการส่งออก, ความเข้ากันได้กับเครื่องหมายและป้ายข้อมูล, และที่ตั้งของคลาสและ enum ในเอกสารอ้างอิง API ที่เกี่ยวข้อง

เพิ่มแถบความคลาดเคลื่อน

Aspose.Slides for Node.js via Java ให้ API ง่าย ๆ สำหรับจัดการค่าของแถบความคลาดเคลื่อน ตัวอย่างโค้ดนี้ใช้เมื่อใช้ประเภทค่าที่กำหนดเอง เพื่อระบุค่า ให้ใช้คุณสมบัติ ErrorBarCustomValues ของจุดข้อมูลเฉพาะในคอลเลกชัน DataPoints ของชุดข้อมูล:

สร้างอินสแตนซ์ของคลาส Presentation
เพิ่มแผนภูมิบับเบิลบนสไลด์ที่ต้องการ
เข้าถึงชุดข้อมูลแผนภูม แรกและตั้งค่ารูปแบบของแถบความคลาดเคลื่อน X
เข้าถึงชุดข้อมูลแผนภูม แรกและตั้งค่ารูปแบบของแถบความคลาดเคลื่อน Y
ตั้งค่าค่าและรูปแบบของแถบ
เขียนการนำเสนอที่แก้ไขแล้วลงในไฟล์ PPTX

// สร้างอินสแตนซ์ของคลาส Presentation
var pres = new aspose.slides.Presentation();
try {
    // สร้างแผนภูมิบับเบิล
    var chart = pres.getSlides().get_Item(0).getShapes().addChart(aspose.slides.ChartType.Bubble, 50, 50, 400, 300, true);
    // เพิ่มแถบความคลาดเคลื่อนและตั้งค่ารูปแบบ
    var errBarX = chart.getChartData().getSeries().get_Item(0).getErrorBarsXFormat();
    var errBarY = chart.getChartData().getSeries().get_Item(0).getErrorBarsYFormat();
    errBarX.isVisible();
    errBarY.isVisible();
    errBarX.setValueType(aspose.slides.ErrorBarValueType.Fixed);
    errBarX.setValue(0.1);
    errBarY.setValueType(aspose.slides.ErrorBarValueType.Percentage);
    errBarY.setValue(5);
    errBarX.setType(aspose.slides.ErrorBarType.Plus);
    errBarY.getFormat().getLine().setWidth(2.0);
    errBarX.hasEndCap();
    // บันทึกการนำเสนอ
    pres.save("ErrorBars.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

เพิ่มค่ารายการแถบความคลาดเคลื่อนแบบกำหนดเอง

Aspose.Slides for Node.js via Java ให้ API ง่าย ๆ สำหรับจัดการค่าของแถบความคลาดเคลื่อนแบบกำหนดเอง ตัวอย่างโค้ดนี้ใช้เมื่อคุณสมบัติ ErrorBarsFormat.ValueType มีค่าเท่ากับ Custom เพื่อระบุค่า ให้ใช้คุณสมบัติ ErrorBarCustomValues ของจุดข้อมูลเฉพาะในคอลเลกชัน DataPoints ของชุดข้อมูล:

สร้างอินสแตนซ์ของคลาส Presentation
เพิ่มแผนภูมิบับเบิลบนสไลด์ที่ต้องการ
เข้าถึงชุดข้อมูลแผนภูม แรกและตั้งค่ารูปแบบของแถบความคลาดเคลื่อน X
เข้าถึงชุดข้อมูลแผนภูม แรกและตั้งค่ารูปแบบของแถบความคลาดเคลื่อน Y
เข้าถึงจุดข้อมูลแต่ละจุดของชุดข้อมูลแผนภูมิและตั้งค่า Error Bar สำหรับจุดข้อมูลแต่ละจุด
ตั้งค่าค่าและรูปแบบของแถบ
เขียนการนำเสนอที่แก้ไขแล้วลงในไฟล์ PPTX

// สร้างอินสแตนซ์ของคลาส Presentation
var pres = new aspose.slides.Presentation();
try {
    // สร้างแผนภูมิบับเบิล
    var chart = pres.getSlides().get_Item(0).getShapes().addChart(aspose.slides.ChartType.Bubble, 50, 50, 400, 300, true);
    // เพิ่มแถบความคลาดเคลื่อนแบบกำหนดเองและตั้งค่ารูปแบบ
    var series = chart.getChartData().getSeries().get_Item(0);
    var errBarX = series.getErrorBarsXFormat();
    var errBarY = series.getErrorBarsYFormat();
    errBarX.isVisible();
    errBarY.isVisible();
    errBarX.setValueType(aspose.slides.ErrorBarValueType.Custom);
    errBarY.setValueType(aspose.slides.ErrorBarValueType.Custom);
    // เข้าถึงจุดข้อมูลของชุดแผนภูมิและตั้งค่าแถบความคลาดเคลื่อนสำหรับ
    // จุดข้อมูลเดี่ยว
    var points = series.getDataPoints();
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForXPlusValues(aspose.slides.DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForXMinusValues(aspose.slides.DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForYPlusValues(aspose.slides.DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForYMinusValues(aspose.slides.DataSourceType.DoubleLiterals);
    // ตั้งค่าแถบความคลาดเคลื่อนสำหรับจุดข้อมูลชุดแผนภูมิ
    for (var 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);
    }
    // บันทึกการนำเสนอ
    pres.save("ErrorBarsCustomValues.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

คำถามที่พบบ่อย

เกิดอะไรขึ้นกับแถบความคลาดเคลื่อนเมื่อส่งออกการนำเสนอเป็น PDF หรือรูปภาพ?

แถบความคลาดเคลื่อนจะถูกแสดงเป็นส่วนหนึ่งของแผนภูมิและจะยังคงอยู่ระหว่างการแปลงพร้อมกับการจัดรูปแบบของแผนภูมิทั้งหมด หากใช้เวอร์ชันหรือเรนเดอร์ที่เข้ากันได้

แถบความคลาดเคลื่อนสามารถรวมกับเครื่องหมายและป้ายข้อมูลได้หรือไม่?

ได้. แถบความคลาดเคลื่อนเป็นองค์ประกอบแยกจากกันและเข้ากันได้กับเครื่องหมายและป้ายข้อมูล; หากองค์ประกอบทับกันอาจต้องปรับการจัดรูปแบบ

ฉันจะค้นหารายการของคุณสมบัติและ enum สำหรับการทำงานกับแถบความคลาดเคลื่อนใน API ได้ที่ไหน?

ในเอกสารอ้างอิง API: คลาส ErrorBarsFormat และ enum ที่เกี่ยวข้อง ErrorBarType และ ErrorBarValueType