تخصيص خطوط الأخطاء في مخططات العروض التقديمية باستخدام PHP

إضافة خطوط الأخطاء

Aspose.Slides for PHP via Java توفر واجهة برمجة تطبيقات بسيطة لإدارة قيم خطوط الأخطاء. يُطبق رمز العينة عند استخدام نوع قيمة مخصص. لتحديد قيمة، استخدم الخاصية ErrorBarCustomValues لنقطة بيانات محددة في مجموعة نقاط البيانات للسلسلة:

  1. إنشاء مثيل من الفئة Presentation.
  2. إضافة مخطط فقاعة إلى الشريحة المطلوبة.
  3. الوصول إلى أول سلسلة مخطط وتعيين تنسيق خط الخطأ X.
  4. الوصول إلى أول سلسلة مخطط وتعيين تنسيق خط الخطأ Y.
  5. تعيين قيم الخطوط وتنسيقها.
  6. حفظ العرض التقديمي المعدل إلى ملف PPTX.
  # إنشاء مثيل من فئة Presentation
  $pres = new Presentation();
  try {
    # إنشاء مخطط فقاعة
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Bubble, 50, 50, 400, 300, true);
    # إضافة خطوط الأخطاء وتعيين تنسيقها
    $errBarX = $chart->getChartData()->getSeries()->get_Item(0)->getErrorBarsXFormat();
    $errBarY = $chart->getChartData()->getSeries()->get_Item(0)->getErrorBarsYFormat();
    $errBarX->isVisible();
    $errBarY->isVisible();
    $errBarX->setValueType(ErrorBarValueType::Fixed);
    $errBarX->setValue(0.1);
    $errBarY->setValueType(ErrorBarValueType::Percentage);
    $errBarY->setValue(5);
    $errBarX->setType(ErrorBarType::Plus);
    $errBarY->getFormat()->getLine()->setWidth(2.0);
    $errBarX->hasEndCap();
    # حفظ العرض التقديمي
    $pres->save("ErrorBars.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

إضافة قيم مخصصة لخطوط الأخطاء

Aspose.Slides for PHP via Java توفر واجهة برمجة تطبيقات بسيطة لإدارة قيم خطوط الأخطاء المخصصة. يُطبق رمز العينة عندما تُعيد الطريقة ErrorBarsFormat::getValueType القيمة Custom. لتحديد قيمة، استخدم الخاصية ErrorBarCustomValues لنقطة بيانات محددة في مجموعة نقاط البيانات للسلسلة:

  1. إنشاء مثيل من الفئة Presentation.
  2. إضافة مخطط فقاعة إلى الشريحة المطلوبة.
  3. الوصول إلى أول سلسلة مخطط وتعيين تنسيق خط الخطأ X.
  4. الوصول إلى أول سلسلة مخطط وتعيين تنسيق خط الخطأ Y.
  5. الوصول إلى نقاط البيانات الفردية لسلسلة المخطط وتعيين قيم خط الخطأ لنقطة البيانات الفردية في السلسلة.
  6. تعيين قيم الخطوط وتنسيقها.
  7. حفظ العرض التقديمي المعدل إلى ملف PPTX.
  # إنشاء مثيل من فئة Presentation
  $pres = new Presentation();
  try {
    # إنشاء مخطط فقاعة
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Bubble, 50, 50, 400, 300, true);
    # إضافة خطوط خطأ مخصصة وتعيين تنسيقها
    $series = $chart->getChartData()->getSeries()->get_Item(0);
    $errBarX = $series->getErrorBarsXFormat();
    $errBarY = $series->getErrorBarsYFormat();
    $errBarX->isVisible();
    $errBarY->isVisible();
    $errBarX->setValueType(ErrorBarValueType::Custom);
    $errBarY->setValueType(ErrorBarValueType::Custom);
    # الوصول إلى نقطة بيانات سلسلة المخطط وتعيين قيم خطوط الخطأ لـ
    # نقطة فردية
    $points = $series->getDataPoints();
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForXPlusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForXMinusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForYPlusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForYMinusValues(DataSourceType::DoubleLiterals);
    # تعيين خطوط الخطأ لنقاط سلسلة المخطط
    for($i = 0; $i < java_values($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", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

الأسئلة الشائعة

ماذا يحدث لخطوط الأخطاء عند تصدير عرض تقديمي إلى PDF أو صور؟ يتم عرضها كجزء من المخطط وتُحفظ أثناء التحويل مع بقية تنسيق المخطط، بافتراض وجود نسخة أو معالج متوافق.

هل يمكن دمج خطوط الأخطاء مع العلامات وملصقات البيانات؟ نعم. خطوط الأخطاء عنصر منفصل ومتوافق مع العلامات وملصقات البيانات؛ إذا تداخلت العناصر، قد تحتاج إلى تعديل التنسيق.

أين يمكنني العثور على قائمة الخصائص والفئات الخاصة بالتعامل مع خطوط الأخطاء في واجهة برمجة التطبيقات؟ في مرجع واجهة برمجة التطبيقات: الفئة ErrorBarsFormat والفئات المرتبطة ErrorBarType وErrorBarValueType.