تنسيق مخططات العرض التقديمي في Java

تنسيق كائنات المخطط

يتيح Aspose.Slides for Java للمطورين إضافة مخططات مخصصة إلى شرائحهم من الصفر. يشرح هذا المقال كيفية تنسيق كائنات المخطط المختلفة بما في ذلك محور الفئة ومحور القيم.

يوفر Aspose.Slides for Java واجهة برمجة تطبيقات بسيطة لإدارة كائنات المخطط المختلفة وتنسيقها باستخدام قيم مخصصة:

  1. إنشاء مثيل من الفئة Presentation .
  2. الحصول على مرجع الشريحة عبر فهرستها.
  3. إضافة مخطط ببيانات افتراضية مع أي نوع مرغوب (في هذا المثال سنستخدم ChartType.LineWithMarkers).
  4. الوصول إلى محور القيم للمخطط وتعيين الخصائص التالية:
    1. تعيين Line format لخطوط الشبكة الرئيسية لمحور القيم
    2. تعيين Line format لخطوط الشبكة الثانوية لمحور القيم
    3. تعيين Number Format لمحور القيم
    4. تعيين Min, Max, Major and Minor units لمحور القيم
    5. تعيين Text Properties لبيانات محور القيم
    6. تعيين Title لمحور القيم
    7. تعيين Line Format لمحور القيم
  5. الوصول إلى محور الفئة للمخطط وتعيين الخصائص التالية:
    1. تعيين Line format لخطوط الشبكة الرئيسية لمحور الفئة
    2. تعيين Line format لخطوط الشبكة الثانوية لمحور الفئة
    3. تعيين Text Properties لبيانات محور الفئة
    4. تعيين Title لمحور الفئة
    5. تعيين Label Positioning لمحور الفئة
    6. تعيين Rotation Angle لتسميات محور الفئة
  6. الوصول إلى مفتاح المخطط وتعيين Text Properties له
  7. ضبط إظهار مفاتيح المخطط دون تداخل مع المخطط
  8. الوصول إلى Secondary Value Axis للمخطط وتعيين الخصائص التالية:
    1. تمكين Value Axis الثانوي
    2. تعيين Line Format لمحور القيم الثانوي
    3. تعيين Number Format لمحور القيم الثانوي
    4. تعيين Min, Max, Major and Minor units لمحور القيم الثانوي
  9. الآن رسم السلسلة الأولى للمخطط على محور القيم الثانوي
  10. ضبط لون تعبئة الجدار الخلفي للمخطط
  11. ضبط لون تعبئة مساحة رسم المخطط
  12. كتابة العرض المعدل إلى ملف PPTX
    // إنشاء مثيل من فئة Presentation
    Presentation pres = new Presentation();
    try {
        // الوصول إلى الشريحة الأولى
        ISlide slide = pres.getSlides().get_Item(0);
    
        // إضافة المخطط التجريبي
        IChart chart = slide.getShapes().addChart(ChartType.LineWithMarkers, 50, 50, 500, 400);
    
        // تعيين عنوان المخطط
        chart.hasTitle();
        chart.getChartTitle().addTextFrameForOverriding("");
        IPortion chartTitle = chart.getChartTitle().getTextFrameForOverriding().getParagraphs().get_Item(0).getPortions().get_Item(0);
        chartTitle.setText("Sample Chart");
        chartTitle.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
        chartTitle.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);
        chartTitle.getPortionFormat().setFontHeight(20);
        chartTitle.getPortionFormat().setFontBold(NullableBool.True);
        chartTitle.getPortionFormat().setFontItalic(NullableBool.True);
    
        // تعيين تنسيق خطوط الشبكة الرئيسية لمحور القيم
        chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
        chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
        chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().setWidth(5);
        chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().setDashStyle(LineDashStyle.DashDot);
    
        // تعيين تنسيق خطوط الشبكة الثانوية لمحور القيم
        chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
        chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.RED);
        chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().setWidth(3);
    
        // تعيين تنسيق رقم محور القيم
        chart.getAxes().getVerticalAxis().isNumberFormatLinkedToSource();
        chart.getAxes().getVerticalAxis().setDisplayUnit(DisplayUnitType.Thousands);
        chart.getAxes().getVerticalAxis().setNumberFormat("0.0%");
    
        // تعيين القيم القصوى والحد الأدنى للمخطط
        chart.getAxes().getVerticalAxis().isAutomaticMajorUnit();
        chart.getAxes().getVerticalAxis().isAutomaticMaxValue();
        chart.getAxes().getVerticalAxis().isAutomaticMinorUnit();
        chart.getAxes().getVerticalAxis().isAutomaticMinValue();
    
        chart.getAxes().getVerticalAxis().setMaxValue(15f);
        chart.getAxes().getVerticalAxis().setMinValue(-2f);
        chart.getAxes().getVerticalAxis().setMinorUnit(0.5f);
        chart.getAxes().getVerticalAxis().setMajorUnit(2.0f);
    
        // تعيين خصائص نص محور القيم
        IChartPortionFormat txtVal = chart.getAxes().getVerticalAxis().getTextFormat().getPortionFormat();
        txtVal.setFontBold(NullableBool.True);
        txtVal.setFontHeight(16);
        txtVal.setFontItalic(NullableBool.True);
        txtVal.getFillFormat().setFillType(FillType.Solid);
        txtVal.getFillFormat().getSolidFillColor().setColor(new Color(PresetColor.DarkGreen));
        txtVal.setLatinFont(new FontData("Times New Roman"));
    
        // تعيين عنوان محور القيم
        chart.getAxes().getVerticalAxis().hasTitle();
        chart.getAxes().getVerticalAxis().getTitle().addTextFrameForOverriding("");
        IPortion valtitle = chart.getAxes().getVerticalAxis().getTitle().getTextFrameForOverriding().getParagraphs().get_Item(0).getPortions().get_Item(0);
        valtitle.setText("Primary Axis");
        valtitle.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
        valtitle.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);
        valtitle.getPortionFormat().setFontHeight(20);
        valtitle.getPortionFormat().setFontBold(NullableBool.True);
        valtitle.getPortionFormat().setFontItalic(NullableBool.True);
    
        // تعيين تنسيق خطوط الشبكة الرئيسية لمحور الفئة
        chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
        chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.GREEN);
        chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().setWidth(5);
    
        // تعيين تنسيق خطوط الشبكة الثانوية لمحور الفئة
        chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
        chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.YELLOW);
        chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().setWidth(3);
    
        // تعيين خصائص نص محور الفئة
        IChartPortionFormat txtCat = chart.getAxes().getHorizontalAxis().getTextFormat().getPortionFormat();
        txtCat.setFontBold(NullableBool.True);
        txtCat.setFontHeight(16);
        txtCat.setFontItalic(NullableBool.True);
        txtCat.getFillFormat().setFillType(FillType.Solid);
        txtCat.getFillFormat().getSolidFillColor().setColor(Color.BLUE);
        txtCat.setLatinFont(new FontData("Arial"));
    
        // تعيين عنوان الفئة
        chart.getAxes().getHorizontalAxis().hasTitle();
        chart.getAxes().getHorizontalAxis().getTitle().addTextFrameForOverriding("");
    
        IPortion catTitle = chart.getAxes().getHorizontalAxis().getTitle().getTextFrameForOverriding().getParagraphs().get_Item(0).getPortions().get_Item(0);
        catTitle.setText("Sample Category");
        catTitle.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
        catTitle.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);
        catTitle.getPortionFormat().setFontHeight(20);
        catTitle.getPortionFormat().setFontBold(NullableBool.True);
        catTitle.getPortionFormat().setFontItalic(NullableBool.True);
    
        // تعيين موقع تسمية محور الفئة
        chart.getAxes().getHorizontalAxis().setTickLabelPosition(TickLabelPositionType.Low);
    
        // تعيين زاوية دوران تسمية محور الفئة
        chart.getAxes().getHorizontalAxis().setTickLabelRotationAngle(45);
    
        // تعيين خصائص نص المفتاح
        IChartPortionFormat txtleg = chart.getLegend().getTextFormat().getPortionFormat();
        txtleg.setFontBold(NullableBool.True);
        txtleg.setFontHeight(16);
        txtleg.setFontItalic(NullableBool.True);
        txtleg.getFillFormat().setFillType(FillType.Solid);
        txtleg.getFillFormat().getSolidFillColor().setColor(new Color(PresetColor.DarkRed));
    
        // تعيين إظهار مفاتيح المخطط دون تداخل مع المخطط
    
        chart.getLegend().setOverlay(true);
        // chart.ChartData.Series[0].PlotOnSecondAxis=true;
    
        chart.getChartData().getSeries().get_Item(0).setPlotOnSecondAxis(true);
        // تعيين محور القيمة الثانوي
        chart.getAxes().getSecondaryVerticalAxis().isVisible();
        chart.getAxes().getSecondaryVerticalAxis().getFormat().getLine().setStyle(LineStyle.ThickBetweenThin);
        chart.getAxes().getSecondaryVerticalAxis().getFormat().getLine().setWidth(20);
    
        // تعيين تنسيق رقم محور القيمة الثانوي
        chart.getAxes().getSecondaryVerticalAxis().isNumberFormatLinkedToSource();
        chart.getAxes().getSecondaryVerticalAxis().setDisplayUnit(DisplayUnitType.Hundreds);
        chart.getAxes().getSecondaryVerticalAxis().setNumberFormat("0.0%");
    
        // تعيين القيم القصوى والحد الأدنى للمخطط
        chart.getAxes().getSecondaryVerticalAxis().isAutomaticMajorUnit();
        chart.getAxes().getSecondaryVerticalAxis().isAutomaticMaxValue();
        chart.getAxes().getSecondaryVerticalAxis().isAutomaticMinorUnit();
        chart.getAxes().getSecondaryVerticalAxis().isAutomaticMinValue();
    
        chart.getAxes().getSecondaryVerticalAxis().setMaxValue(20f);
        chart.getAxes().getSecondaryVerticalAxis().setMinValue(-5f);
        chart.getAxes().getSecondaryVerticalAxis().setMinorUnit(0.5f);
        chart.getAxes().getSecondaryVerticalAxis().setMajorUnit(2.0f);
    
        // تعيين لون جدار المخطط الخلفي
        chart.getBackWall().setThickness(1);
        chart.getBackWall().getFormat().getFill().setFillType(FillType.Solid);
        chart.getBackWall().getFormat().getFill().getSolidFillColor().setColor(Color.ORANGE);
    
        chart.getFloor().getFormat().getFill().setFillType(FillType.Solid);
        chart.getFloor().getFormat().getFill().getSolidFillColor().setColor(Color.RED);
        // تعيين لون منطقة الرسم
        chart.getPlotArea().getFormat().getFill().setFillType(FillType.Solid);
        chart.getPlotArea().getFormat().getFill().getSolidFillColor().setColor(new Color(PresetColor.LightCyan));
    
        // حفظ العرض التقديمي
        pres.save("FormattedChart.pptx", SaveFormat.Pptx);
    } finally {
        if (pres != null) pres.dispose();
    }

تعيين خصائص الخط للمخطط

يوفر Aspose.Slides for Java دعمًا لتعيين خصائص الخط المتعلقة بالمخطط. يرجى اتباع الخطوات التالية لتعيين خصائص الخط للمخطط.

  • إنشاء كائن الفئة Presentation .
  • إضافة مخطط إلى الشريحة.
  • ضبط ارتفاع الخط.
  • حفظ العرض المعدل.

تم تقديم مثال نموذجي أدناه.

// إنشاء مثيل من فئة Presentation
Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 100, 500, 400);
    
    chart.getTextFormat().getPortionFormat().setFontHeight(20);
    chart.getChartData().getSeries().get_Item(0).getLabels().getDefaultDataLabelFormat().setShowValue(true);
    
    pres.save("FontPropertiesForChart.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

تعيين تنسيق الأرقام

يوفر Aspose.Slides for Java واجهة برمجة تطبيقات بسيطة لإدارة تنسيق بيانات المخطط:

  1. إنشاء مثيل من الفئة Presentation .
  2. الحصول على مرجع الشريحة عبر فهرستها.
  3. إضافة مخطط ببيانات افتراضية مع أي نوع مرغوب (هذا المثال يستخدم ChartType.ClusteredColumn).
  4. تعيين تنسيق الأرقام المسبق من القيم المسبقة المتاحة.
  5. المرور عبر خلايا بيانات المخطط في كل سلسلة وتعيين تنسيق رقم البيانات.
  6. حفظ العرض.
  7. تعيين تنسيق رقم مخصص.
  8. المرور عبر خلايا بيانات المخطط داخل كل سلسلة وتعيين تنسيق رقم مختلف.
  9. حفظ العرض.
// إنشاء مثيل من فئة Presentation
Presentation pres = new Presentation();
try {
    // الوصول إلى الشريحة الأولى للعرض التقديمي
    ISlide slide = pres.getSlides().get_Item(0);

    // إضافة مخطط أعمدة متجمعة افتراضي
    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 400);

    // الوصول إلى مجموعة سلاسل المخطط
    IChartSeriesCollection series = chart.getChartData().getSeries();
    
    // التجول عبر كل سلسلة مخطط
    for (IChartSeries ser : series) 
    {
        // التجول عبر كل خلية بيانات في السلسلة
        for (IChartDataPoint cell : ser.getDataPoints()) 
        {
            // تعيين تنسيق الرقم
            cell.getValue().getAsCell().setPresetNumberFormat((byte) 10); // 0.00%
        }
    }

    // حفظ العرض التقديمي
    pres.save("PresetNumberFormat.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

القيم المسبقة لتنسيق الأرقام المتاحة مع فهرسها المسبق والتي يمكن استخدامها مذكورة أدناه:

0 عام
1 0
2 0.00
3 #,##0
4 #,##0.00
5 $#,##0;$-#,##0
6 $#,##0;Red$-#,##0
7 $#,##0.00;$-#,##0.00
8 $#,##0.00;Red$-#,##0.00
9 0%
10 0.00%
11 0.00E+00
12 # ?/?
13 # /
14 m/d/yy
15 d-mmm-yy
16 d-mmm
17 mmm-yy
18 h:mm AM/PM
19 h:mm:ss AM/PM
20 h:mm
21 h:mm:ss
22 m/d/yy h:mm
37 #,##0;-#,##0
38 #,##0;Red-#,##0
39 #,##0.00;-#,##0.00
40 #,##0.00;Red-#,##0.00
41 _ * #,##0_ ;_ * “_ ;_ @_
42 _ $* #,##0_ ;_ $* “_ ;_ @_
43 _ * #,##0.00_ ;_ * “??_ ;_ @_
44 _ $* #,##0.00_ ;_ $* “??_ ;_ @_
45 mm:ss
46 h :mm:ss
47 mm:ss.0
48 ##0.0E+00
49 @

تعيين حدود مستديرة لمنطقة المخطط

يوفر Aspose.Slides for Java دعمًا لتعيين منطقة المخطط. تم إضافة الطريقتين hasRoundedCorners وsetRoundedCorners إلى واجهة IChart وفئة Chart .

  1. إنشاء كائن الفئة Presentation .
  2. إضافة مخطط إلى الشريحة.
  3. ضبط نوع التعبئة ولون تعبئة المخطط
  4. ضبط خاصية الزوايا المستديرة إلى True.
  5. حفظ العرض المعدل.

تم تقديم مثال نموذجي أدناه.

// إنشاء مثيل من فئة Presentation
Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    
    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 100, 600, 400);
    chart.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    chart.getLineFormat().setStyle(LineStyle.Single);
    chart.setRoundedCorners(true);

    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

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

هل يمكنني تعيين تعبئات شبه شفافة للأعمدة/المناطق مع الحفاظ على الحد غير شفاف؟

نعم. يتم تكوين شفافية التعبئة والحد بشكل منفصل. هذا مفيد لتحسين قابلية القراءة للشبكة والبيانات في التصورات الكثيفة.

كيف يمكنني التعامل مع تسميات البيانات عندما تتداخل؟

قلل حجم الخط، أو عطل مكونات التسمية غير الأساسية (مثل الفئات)، أو اضبط إزاحة/موضع التسمية، أو اعرض التسميات فقط للنقاط المحددة إذا لزم الأمر، أو غيّر التنسيق إلى “القيمة + المفتاح”.

هل يمكنني تطبيق تعبئات تدرجية أو نمطية على السلاسل؟

نعم. تتوفر عادةً تعبئات صلبة وتدرجية/نمطية. في الممارسة العملية، استخدم التدرجات بحذر وتجنب الجمعيات التي تقلل التباين مع الشبكة والنص.

تحسين حسابات المخطط للعروض التقديمية في جافا تطبيق صيغ ورقة عمل المخطط في العروض التقديمية باستخدام Java