# إضافة خطوط الاتجاه إلى مخططات العرض التقديمي في Python

> أضف وخصص خطوط الاتجاه بسرعة في مخططات PowerPoint و OpenDocument باستخدام Aspose.Slides for Python عبر .NET — دليل عملي وأمثلة شفرة لتحسين دقة التنبؤ وجذب جمهورك.

Source: https://docs.aspose.com/slides/ar/python-net/trend-line/
Updated: 2025-12-08


## **إضافة خط الاتجاه**
Aspose.Slides for Python عبر .NET توفر واجهة برمجة تطبيقات بسيطة لإدارة خطوط الاتجاه المختلفة في المخططات:

1. إنشاء كائن من الفئة [Presentation](https://reference.aspose.com/slides/python-net/aspose.slides/presentation/).
2. الحصول على مرجع الشريحة باستخدام فهرسها.
3. إضافة مخطط ببيانات افتراضية مع أي نوع مرغوب (هذا المثال يستخدم ChartType.CLUSTERED_COLUMN).
4. إضافة خط اتجاه أسي للسلسلة 1 في المخطط.
5. إضافة خط اتجاه خطّي للسلسلة 1 في المخطط.
6. إضافة خط اتجاه لوغاريتمي للسلسلة 2 في المخطط.
7. إضافة خط اتجاه متوسط متحرك للسلسلة 2 في المخطط.
8. إضافة خط اتجاه متعدد الحدود للسلسلة 3 في المخطط.
9. إضافة خط اتجاه قوّي للسلسلة 3 في المخطط.
10. حفظ العرض التقديمي المعدل إلى ملف PPTX.

الكود التالي يستخدم لإنشاء مخطط مع خطوط الاتجاه.
```py
import aspose.slides.charts as charts
import aspose.slides as slides
import aspose.pydrawing as draw

    # إنشاء عرض تقديمي فارغ
    with slides.Presentation() as pres:

        # إنشاء مخطط عمود مجمع
        chart = pres.slides[0].shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 400)

        # إضافة خط اتجاه أسي للسلسلة 1
        tredLinep = chart.chart_data.series[0].trend_lines.add(charts.TrendlineType.EXPONENTIAL)
        tredLinep.display_equation = False
        tredLinep.display_r_squared_value = False

        # إضافة خط اتجاه خطي للسلسلة 1
        tredLineLin = chart.chart_data.series[0].trend_lines.add(charts.TrendlineType.LINEAR)
        tredLineLin.trendline_type = charts.TrendlineType.LINEAR
        tredLineLin.format.line.fill_format.fill_type = slides.FillType.SOLID
        tredLineLin.format.line.fill_format.solid_fill_color.color = draw.Color.red


        # إضافة خط اتجاه لوغاريتمي للسلسلة 2
        tredLineLog = chart.chart_data.series[1].trend_lines.add(charts.TrendlineType.LOGARITHMIC)
        tredLineLog.trendline_type = charts.TrendlineType.LOGARITHMIC
        tredLineLog.add_text_frame_for_overriding("New log trend line")

        # إضافة خط اتجاه متوسط متحرك للسلسلة 2
        tredLineMovAvg = chart.chart_data.series[1].trend_lines.add(charts.TrendlineType.MOVING_AVERAGE)
        tredLineMovAvg.trendline_type = charts.TrendlineType.MOVING_AVERAGE
        tredLineMovAvg.period = 3
        tredLineMovAvg.trendline_name = "New TrendLine Name"

        # إضافة خط اتجاه متعدد الحدود للسلسلة 3
        tredLinePol = chart.chart_data.series[2].trend_lines.add(charts.TrendlineType.POLYNOMIAL)
        tredLinePol.trendline_type = charts.TrendlineType.POLYNOMIAL
        tredLinePol.forward = 1
        tredLinePol.order = 3

        # إضافة خط اتجاه أسّي للسلسلة 3
        tredLinePower = chart.chart_data.series[1].trend_lines.add(charts.TrendlineType.POWER)
        tredLinePower.trendline_type = charts.TrendlineType.POWER
        tredLinePower.backward = 1

        # حفظ العرض التقديمي
        pres.save("Charttrend_lines_out.pptx", slides.export.SaveFormat.PPTX)
```




## **إضافة خط مخصص**
Aspose.Slides for Python عبر .NET توفر واجهة برمجة تطبيقات بسيطة لإضافة خطوط مخصصة في المخطط. لإضافة خط بسيط إلى شريحة مختارة من العرض التقديمي، يرجى اتباع الخطوات التالية:

- إنشاء نسخة من الفئة Presentation
- الحصول على مرجع شريحة باستخدام الفهرس الخاص بها
- إنشاء مخطط جديد باستخدام طريقة AddChart المتوفرة في كائن Shapes
- إضافة AutoShape من نوع خط باستخدام طريقة AddAutoShape المتوفرة في كائن Shapes
- تعيين لون خطوط الشكل.
- حفظ العرض التقديمي المعدل كملف PPTX

الكود التالي يستخدم لإنشاء مخطط مع خطوط مخصصة.
```py
import aspose.slides.charts as charts
import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as pres:
    chart = pres.slides[0].shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 100, 100, 500, 400)
    shape = chart.user_shapes.shapes.add_auto_shape(slides.ShapeType.LINE, 0, chart.height / 2, chart.width, 0)
    shape.line_format.fill_format.fill_type = slides.FillType.SOLID
    shape.line_format.fill_format.solid_fill_color.color = draw.Color.red
    pres.save("AddCustomLines.pptx", slides.export.SaveFormat.PPTX)
```


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

**ماذا يعني 'forward' و 'backward' لخط الاتجاه؟**

إنهما أطوال خط الاتجاه الممتدة إلى الأمام/الخلف: للمخططات المبعثرة (XY) — بوحدات المحور؛ للمخططات غير المبعثرة — بعدد الفئات. يُسمح فقط بالقيم غير السالبة.

**هل سيُحافظ على خط الاتجاه عند تصدير العرض التقديمي إلى PDF أو SVG، أو عند تحويل شريحة إلى صورة؟**

نعم. تقوم Aspose.Slides بتحويل العروض التقديمية إلى [PDF](/slides/ar/python-net/convert-powerpoint-to-pdf/)/[SVG](/slides/ar/python-net/render-a-slide-as-an-svg-image/) وتُصوّر المخططات كصور؛ خطوط الاتجاه، كجزء من المخطط، تُحافظ عليها هذه العمليات. كما تتوفر طريقة لـ[تصدير صورة للمخطط](/slides/ar/python-net/create-shape-thumbnails/) نفسه.