كيفية العمل مع المخططات في .NET

الخطوة 1: الحصول على المكتبة

استنساخ المستودع وبناء Aspose.Words.sln في وضع الإصدار، ثم أضف إشارة مشروع إلى Aspose.Words.csproj من مشروعك الخاص .NET، كما هو موضح في الـ دليل التثبيت.

الخطوة 2: إدراج مخطط وتبسيط مظهره

DocumentBuilder.InsertChart(chartType, width, height) يُدرج شكل مخطط عند المؤشر ويعيد الـ Shape المحتوي؛ خاصية Chart الخاصة به هي كائن Chart الذي تقوم بتكوينه، مع AxisX وAxisY وLegend وTitle كالكائنات الفرعية الرئيسية له. أنواع المخططات موجودة في مساحة الاسم Aspose.Words.Drawing.Charts إلى جانب مساحة الاسم الأساسية Aspose.Words. مخطط ChartType.Bar بسيط وجاهز للعرض على Document جديد غالبًا ما يعني ضبط Legend.Position إلى LegendPosition.None، وضبط Hidden وHasMajorGridlines على AxisY وAxisX، وتعيين Title.Show إلى false، مسح العنصر النائب ChartSeriesCollection باستخدام Series.Clear() قبل استدعاء Series.Add(seriesName, categories, values)، تثبيت AxisY.Scaling.Maximum إلى AxisBound ثابت بدلاً من السماح له بالتحجيم التلقائي، ثم كتابة النتيجة باستخدام Document.Save. المثال الكامل — Document، DocumentBuilder، Chart، AxisX، AxisY، Legend، Title، ChartSeriesCollection، AxisBound، وDocument.Save — يبدو هكذا:

using Aspose.Words;
using Aspose.Words.Drawing.Charts;

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Bar, 432, 252);
Chart chart = shape.Chart;
chart.Legend.Position = LegendPosition.None;

ChartSeriesCollection seriesColl = chart.Series;
chart.AxisY.Hidden = true;
chart.AxisY.HasMajorGridlines = false;
chart.AxisX.Hidden = true;
chart.Title.Show = false;

seriesColl.Clear();
chart.AxisY.Scaling.Maximum = new AxisBound(100);

string[] categories = new string[] { "AW Category 1" };
seriesColl.Add("AW Series 1", categories, new double[] { 30 });

doc.Save("chart.docx");

يقوم هذا بإنشاء Document، يُدرج مخطط ChartType.Bar، يضبط Chart.Legend.Position إلى LegendPosition.None لإخفاء المفتاح، يضبط Hidden = true و HasMajorGridlines = false على chart.AxisY و Hidden = true على chart.AxisX، يضبط chart.Title.Show = false، يمسح سلسلة العناصر النائبة باستخدام seriesColl.Clear()، يثبت محور القيم إلى حد أقصى 100 عبر chart.AxisY.Scaling.Maximum = new AxisBound(100)، يضيف سلسلة حقيقية واحدة باستخدام seriesColl.Add(seriesName, categories, values)، ويكتب النتيجة باستخدام Document.Save.

الخطوة 3: اختر نوع مخطط مختلف

ChartType تغطي عائلات المخططات القياسية في Word — Line، Bar، Column (بالإضافة إلى المتغيرات Stacked، PercentStacked، و3D)، Pie، PieOfPie، Doughnut، Area، Scatter، Bubble، Radar، Stock، Surface، وأنواع Word 2016 Treemap، Sunburst، Histogram، Pareto، BoxAndWhisker، وWaterfall. مرّر القيمة التي تريدها كمعامل chartType إلى InsertChart — لا يوجد عضو يغيّر نوع مخطط موجود بعد الإدراج، لذا اختر النوع الصحيح مسبقًا أو استبدل الشكل.

الخطوة 4: إضافة وتنسيق تسميات البيانات

اضبط series.HasDataLabels = true قبل تكوين series.DataLabels (وهو ChartDataLabelCollection) — لا تؤثر مفاتيح العرض الخاصة به بشكل مرئي عندما تكون التسميات مُعطلة. ShowValue، ShowCategoryName، وShowPercentage تتحكم في أي أجزاء من المعلومات تظهر، وPosition يضعها بالنسبة إلى نقطة البيانات.

الخطوة 5: تنسيق نقطة بيانات فردية

افهرس إلى DataPoints لسلسلة (وهو ChartDataPointCollection) للوصول إلى ChartDataPoint واحد وتعيين Format أو Marker أو Explosion أو InvertIfNegative بشكل مستقل عن بقية السلسلة. بهذه الطريقة يمكنك إبراز شريط أو شريحة أو علامة واحدة دون إعادة تنسيق السلسلة بأكملها.