تنسيق عدد بيانات التسمية في الرسم البياني

مقدمة

غالبًا ما يتضمن إنشاء مستندات جذابة وغنية بالمعلومات تضمين مخططات تحتوي على تسميات بيانات منسقة بشكل جيد. إذا كنت مطورًا لـ .NET وترغب في تحسين مستندات Word الخاصة بك باستخدام مخططات متطورة، فإن Aspose.Words for .NET هي مكتبة رائعة تساعدك على تحقيق ذلك. سيرشدك هذا البرنامج التعليمي خلال عملية تنسيق تسميات الأرقام في مخطط باستخدام Aspose.Words for .NET، خطوة بخطوة.

المتطلبات الأساسية

قبل الغوص في الكود، هناك بعض المتطلبات الأساسية التي يجب أن تكون موجودة:

Aspose.Words for .NET: تأكد من تثبيت مكتبة Aspose.Words for .NET. إذا لم تقم بتثبيتها بعد، فيمكنكتحميله هنا.
بيئة التطوير: يجب أن يكون لديك بيئة تطوير .NET. يوصى بشدة باستخدام Visual Studio.
المعرفة الأساسية بلغة C#: تعتبر المعرفة ببرمجة C# ضرورية لأن هذا البرنامج التعليمي يتضمن كتابة وفهم كود C#.
ترخيص مؤقت: لاستخدام Aspose.Words دون أي قيود، يمكنك الحصول علىرخصة مؤقتة.

الآن، دعونا نتعمق في عملية تنسيق تسميات الأرقام في الرسم البياني خطوة بخطوة.

استيراد مساحات الأسماء

أولاً وقبل كل شيء، نحتاج إلى استيراد مساحات الأسماء اللازمة للعمل مع Aspose.Words لـ .NET. أضف الأسطر التالية في أعلى ملف C# الخاص بك:

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

الخطوة 1: إعداد دليل المستندات الخاص بك

قبل أن تتمكن من البدء في معالجة مستند Word الخاص بك، يتعين عليك تحديد الدليل الذي سيتم حفظ المستند فيه. وهذا أمر ضروري لعملية الحفظ لاحقًا.

string dataDir = "YOUR DOCUMENT DIRECTORY";

يستبدل"YOUR DOCUMENT DIRECTORY" مع المسار الفعلي إلى دليل المستند الخاص بك.

الخطوة 2: تهيئة المستند وDocumentBuilder

الخطوة التالية هي تهيئة ملف جديدDocument و أDocumentBuilder . الDocumentBuilder هي فئة مساعدة تسمح لنا بإنشاء محتوى المستند.

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

الخطوة 3: إدراج مخطط في المستند

الآن، دعنا ندرج مخططًا في المستند باستخدامDocumentBuilderفي هذا البرنامج التعليمي، سنستخدم مخططًا خطيًا كمثال.

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
chart.Title.Text = "Data Labels With Different Number Format";

هنا نقوم بإدراج مخطط خطي بعرض وارتفاع محددين، ونضع عنوان المخطط.

الخطوة 4: مسح السلسلة الافتراضية وإضافة سلسلة جديدة

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

// حذف السلسلة المولدة افتراضيا.
chart.Series.Clear();

// إضافة سلسلة جديدة بنقاط بيانات مخصصة.
ChartSeries series1 = chart.Series.Add("Aspose Series 1", 
	new string[] { "Category 1", "Category 2", "Category 3" }, 
	new double[] { 2.5, 1.5, 3.5 });

الخطوة 5: تمكين تسميات البيانات

لعرض تسميات البيانات على الرسم البياني، نحتاج إلى تمكينها لسلسلتنا.

series1.HasDataLabels = true;
series1.DataLabels.ShowValue = true;

الخطوة 6: تنسيق تسميات البيانات

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

series1.DataLabels[0].NumberFormat.FormatCode = "\"$\"#,##0.00"; // تنسيق العملة
series1.DataLabels[1].NumberFormat.FormatCode = "dd/mm/yyyy"; // تنسيق التاريخ
series1.DataLabels[2].NumberFormat.FormatCode = "0.00%"; // تنسيق النسبة المئوية

بالإضافة إلى ذلك، يمكنك ربط تنسيق تسمية البيانات بخلية المصدر. عند الربط،NumberFormat سيتم إعادة تعيينها إلى عامة وتوارثها من الخلية المصدر.

series1.DataLabels[2].NumberFormat.IsLinkedToSource = true;

الخطوة 7: حفظ المستند

وأخيرًا، قم بحفظ المستند في الدليل المحدد.

doc.Save(dataDir + "WorkingWithCharts.FormatNumberOfDataLabel.docx");

يؤدي هذا إلى حفظ مستندك بالاسم المحدد ويضمن الحفاظ على الرسم البياني الخاص بك مع تسميات البيانات المنسقة.

خاتمة

إن تنسيق تسميات البيانات في مخطط باستخدام Aspose.Words for .NET يمكن أن يعزز بشكل كبير من قابلية قراءة مستندات Word واحترافيتها. باتباع هذا الدليل التفصيلي، يجب أن تكون قادرًا الآن على إنشاء مخطط وإضافة سلسلة بيانات وتنسيق تسميات البيانات لتلبية احتياجاتك. Aspose.Words for .NET هي أداة قوية تسمح بالتخصيص والأتمتة الشاملة لمستندات Word، مما يجعلها أصلًا لا يقدر بثمن لمطوري .NET.

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

ما هو Aspose.Words لـ .NET؟

Aspose.Words for .NET هي مكتبة قوية لإنشاء مستندات Word ومعالجتها وتحويلها برمجيًا باستخدام C#.

هل يمكنني تنسيق أنواع أخرى من الرسوم البيانية باستخدام Aspose.Words لـ .NET؟

نعم، يدعم Aspose.Words for .NET مجموعة متنوعة من أنواع المخططات، بما في ذلك المخطط الشريطي، والمخطط العمودي، والمخطط الدائري، والمزيد.

كيف يمكنني الحصول على ترخيص مؤقت لـ Aspose.Words لـ .NET؟

يمكنك الحصول على ترخيص مؤقتهنا.

هل من الممكن ربط تسميات البيانات بالخلايا المصدرية في Excel؟

نعم، يمكنك ربط تسميات البيانات بالخلايا المصدرية، مما يسمح بتوارث تنسيق الأرقام من الخلية المصدرية.

أين يمكنني العثور على المزيد من الوثائق التفصيلية لـ Aspose.Words لـ .NET؟

يمكنك العثور على وثائق شاملةهنا.