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

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

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

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

  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 pres = new Presentation();

 // الوصول إلى الشريحة الأولى
ISlide slide = pres.Slides[0];

 // إضافة المخطط النموذجي
IChart chart = slide.Shapes.AddChart(ChartType.LineWithMarkers, 50, 50, 500, 400);

 // ضبط عنوان المخطط
chart.HasTitle = true;
chart.ChartTitle.AddTextFrameForOverriding("");
IPortion chartTitle = chart.ChartTitle.TextFrameForOverriding.Paragraphs[0].Portions[0];
chartTitle.Text = "Sample Chart";
chartTitle.PortionFormat.FillFormat.FillType = FillType.Solid;
chartTitle.PortionFormat.FillFormat.SolidFillColor.Color = Color.Gray;
chartTitle.PortionFormat.FontHeight = 20;
chartTitle.PortionFormat.FontBold = NullableBool.True;
chartTitle.PortionFormat.FontItalic = NullableBool.True;

 // ضبط تنسيق خطوط الشبكة الرئيسية لمحور القيم
chart.Axes.VerticalAxis.MajorGridLinesFormat.Line.FillFormat.FillType = FillType.Solid;
chart.Axes.VerticalAxis.MajorGridLinesFormat.Line.FillFormat.SolidFillColor.Color = Color.Blue;
chart.Axes.VerticalAxis.MajorGridLinesFormat.Line.Width = 5;
chart.Axes.VerticalAxis.MajorGridLinesFormat.Line.DashStyle = LineDashStyle.DashDot;

 // ضبط تنسيق خطوط الشبكة الفرعية لمحور القيم
chart.Axes.VerticalAxis.MinorGridLinesFormat.Line.FillFormat.FillType = FillType.Solid;
chart.Axes.VerticalAxis.MinorGridLinesFormat.Line.FillFormat.SolidFillColor.Color = Color.Red;
chart.Axes.VerticalAxis.MinorGridLinesFormat.Line.Width = 3;

 // ضبط تنسيق أرقام محور القيم
chart.Axes.VerticalAxis.IsNumberFormatLinkedToSource = false;
chart.Axes.VerticalAxis.DisplayUnit = DisplayUnitType.Thousands;
chart.Axes.VerticalAxis.NumberFormat = "0.0%";

 // ضبط القيم القصوى والدنيا للمخطط
chart.Axes.VerticalAxis.IsAutomaticMajorUnit = false;
chart.Axes.VerticalAxis.IsAutomaticMaxValue = false;
chart.Axes.VerticalAxis.IsAutomaticMinorUnit = false;
chart.Axes.VerticalAxis.IsAutomaticMinValue = false;

chart.Axes.VerticalAxis.MaxValue = 15f;
chart.Axes.VerticalAxis.MinValue = -2f;
chart.Axes.VerticalAxis.MinorUnit = 0.5f;
chart.Axes.VerticalAxis.MajorUnit = 2.0f;

 // ضبط خصائص نص محور القيم
IChartPortionFormat txtVal = chart.Axes.VerticalAxis.TextFormat.PortionFormat;
txtVal.FontBold = NullableBool.True;
txtVal.FontHeight = 16;
txtVal.FontItalic = NullableBool.True;
txtVal.FillFormat.FillType = FillType.Solid; ;
txtVal.FillFormat.SolidFillColor.Color = Color.DarkGreen;
txtVal.LatinFont = new FontData("Times New Roman");

 // ضبط عنوان محور القيم
chart.Axes.VerticalAxis.HasTitle = true;
chart.Axes.VerticalAxis.Title.AddTextFrameForOverriding("");
IPortion valtitle = chart.Axes.VerticalAxis.Title.TextFrameForOverriding.Paragraphs[0].Portions[0];
valtitle.Text = "Primary Axis";
valtitle.PortionFormat.FillFormat.FillType = FillType.Solid;
valtitle.PortionFormat.FillFormat.SolidFillColor.Color = Color.Gray;
valtitle.PortionFormat.FontHeight = 20;
valtitle.PortionFormat.FontBold = NullableBool.True;
valtitle.PortionFormat.FontItalic = NullableBool.True;

 // ضبط تنسيق خط محور القيم : الآن مهمل
 // chart.Axes.VerticalAxis.aVerticalAxis.l.AxisLine.Width = 10;
 // chart.Axes.VerticalAxis.AxisLine.FillFormat.FillType = FillType.Solid;
 // Chart.Axes.VerticalAxis.AxisLine.FillFormat.SolidFillColor.Color = Color.Red;

 // ضبط تنسيق خطوط الشبكة الرئيسية لمحور الفئات
chart.Axes.HorizontalAxis.MajorGridLinesFormat.Line.FillFormat.FillType = FillType.Solid;
chart.Axes.HorizontalAxis.MajorGridLinesFormat.Line.FillFormat.SolidFillColor.Color = Color.Green;
chart.Axes.HorizontalAxis.MajorGridLinesFormat.Line.Width = 5;

 // ضبط تنسيق خطوط الشبكة الفرعية لمحور الفئات
chart.Axes.HorizontalAxis.MinorGridLinesFormat.Line.FillFormat.FillType = FillType.Solid;
chart.Axes.HorizontalAxis.MinorGridLinesFormat.Line.FillFormat.SolidFillColor.Color = Color.Yellow;
chart.Axes.HorizontalAxis.MinorGridLinesFormat.Line.Width = 3;

 // ضبط خصائص نص محور الفئات
IChartPortionFormat txtCat = chart.Axes.HorizontalAxis.TextFormat.PortionFormat;
txtCat.FontBold = NullableBool.True;
txtCat.FontHeight = 16;
txtCat.FontItalic = NullableBool.True;
txtCat.FillFormat.FillType = FillType.Solid; ;
txtCat.FillFormat.SolidFillColor.Color = Color.Blue;
txtCat.LatinFont = new FontData("Arial");

 // ضبط عنوان محور الفئات
chart.Axes.HorizontalAxis.HasTitle = true;
chart.Axes.HorizontalAxis.Title.AddTextFrameForOverriding("");

IPortion catTitle = chart.Axes.HorizontalAxis.Title.TextFrameForOverriding.Paragraphs[0].Portions[0];
catTitle.Text = "Sample Category";
catTitle.PortionFormat.FillFormat.FillType = FillType.Solid;
catTitle.PortionFormat.FillFormat.SolidFillColor.Color = Color.Gray;
catTitle.PortionFormat.FontHeight = 20;
catTitle.PortionFormat.FontBold = NullableBool.True;
catTitle.PortionFormat.FontItalic = NullableBool.True;

 // ضبط موضع تسمية محور الفئات
chart.Axes.HorizontalAxis.TickLabelPosition = TickLabelPositionType.Low;

 // ضبط زاوية تدوير تسمية محور الفئات
chart.Axes.HorizontalAxis.TickLabelRotationAngle = 45;

 // ضبط خصائص نص وسيلة الإيضاح
IChartPortionFormat txtleg = chart.Legend.TextFormat.PortionFormat;
txtleg.FontBold = NullableBool.True;
txtleg.FontHeight = 16;
txtleg.FontItalic = NullableBool.True;
txtleg.FillFormat.FillType = FillType.Solid; ;
txtleg.FillFormat.SolidFillColor.Color = Color.DarkRed;

 // إظهار وسيلة إيضاح المخطط دون تداخل مع المخطط

chart.Legend.Overlay = true;
            
 // رسم السلسلة الأولى على محور القيم الثانوي
 // Chart.ChartData.Series[0].PlotOnSecondAxis = true;

 // ضبط لون جدار خلفية المخطط
chart.BackWall.Thickness = 1;
chart.BackWall.Format.Fill.FillType = FillType.Solid;
chart.BackWall.Format.Fill.SolidFillColor.Color = Color.Orange;

chart.Floor.Format.Fill.FillType = FillType.Solid;
chart.Floor.Format.Fill.SolidFillColor.Color = Color.Red;
 // ضبط لون منطقة الرسم
chart.PlotArea.Format.Fill.FillType = FillType.Solid;
chart.PlotArea.Format.Fill.SolidFillColor.Color = Color.LightCyan;

// حفظ العرض التقديمي
pres.Save("FormattedChart_out.pptx", SaveFormat.Pptx);

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

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

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

مثال العينة التالي موضح.

using (Presentation pres = new Presentation())
{               
    IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.ClusteredColumn, 100, 100, 500, 400);
    chart.TextFormat.PortionFormat.FontHeight = 20;
    chart.ChartData.Series[0].Labels.DefaultDataLabelFormat.ShowValue = true;
    pres.Save("FontPropertiesForChart.pptx", SaveFormat.Pptx);
}

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

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

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

// الوصول إلى الشريحة الأولى للعرض التقديمي
ISlide slide = pres.Slides[0];

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

// الوصول إلى مجموعة سلاسل المخطط
IChartSeriesCollection series = chart.ChartData.Series;

// ضبط تنسيق الأرقام المحدد مسبقًا
// التنقل عبر كل سلسلة مخطط
foreach (ChartSeries ser in series)
{
    // التنقل عبر كل خلية بيانات في السلسلة
    foreach (IChartDataPoint cell in ser.DataPoints)
    {
        // ضبط تنسيق الرقم
        cell.Value.AsCell.PresetNumberFormat = 10; //0.00%
    }
}

// حفظ العرض التقديمي
pres.Save("PresetNumberFormat_out.pptx", SaveFormat.Pptx);

القيم المسبقة المتاحة لتنسيق الأرقام مع مؤشرها المسبق هي كما يلي:

0 General
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 .NET يوفر دعمًا لتعيين منطقة المخطط. تم إضافة الخصائص IChart.HasRoundedCorners و Chart.HasRoundedCorners في Aspose.Slides.

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

العينة التالية موضحة.

using (Presentation presentation = new Presentation())
{
	ISlide slide = presentation.Slides[0];
	IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 100, 600, 400);
	chart.LineFormat.FillFormat.FillType = FillType.Solid;
	chart.LineFormat.Style = LineStyle.Single;
	chart.HasRoundedCorners = true;

	presentation.Save("out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

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

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

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

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

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

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

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

تحسين حسابات المخطط للعروض التقديمية في .NET إدارة دفاتر عمل المخططات في العروض التقديمية في .NET