تعيين خيارات افتراضية لعلامات البيانات في الرسم البياني

مقدمة

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

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

قبل أن نبدأ، دعنا نتأكد من أنك تمتلك كل ما تحتاجه لمتابعة هذا البرنامج التعليمي. إليك قائمة مرجعية سريعة:

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

بمجرد حصولك على هذه المتطلبات الأساسية، سنكون جاهزين للانطلاق!

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

أولاً وقبل كل شيء، دعنا ننشئ مشروعنا ونستورد المساحات الأساسية اللازمة. هذه المساحات الأساسية ضرورية للوصول إلى وظيفة Aspose.Words.

using System;
using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.ReportingServices;

الخطوة 1: إنشاء مستند جديد

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

// المسار إلى دليل المستند الخاص بك
string dataDir = "YOUR DOCUMENT DIRECTORY";

// إنشاء مستند جديد
Document doc = new Document();

// تهيئة DocumentBuilder
DocumentBuilder builder = new DocumentBuilder(doc);

توضيح

في هذه الخطوة، قمنا بإعداد المستند والمنشئ الذي سنستخدمه لإدراج المحتوى وتنسيقه.dataDir يحتوي المتغير على المسار الذي سنحفظ فيه مستندنا النهائي.

الخطوة 2: إدراج مخطط

بعد ذلك، سنضيف مخططًا دائريًا إلى مستندنا.InsertChart طريقةDocumentBuilder تجعل هذه الفئة هذا الأمر سهلاً للغاية.

// إدراج مخطط دائري
Shape shape = builder.InsertChart(ChartType.Pie, 432, 252);

// الوصول إلى كائن الرسم البياني
Chart chart = shape.Chart;

توضيح

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

الخطوة 3: تخصيص سلسلة المخططات

الآن، سنقوم بمسح أي سلسلة موجودة في الرسم البياني وإضافة السلسلة المخصصة. ستمثل هذه السلسلة نقاط البيانات الخاصة بنا.

// مسح سلسلة المخططات الموجودة
chart.Series.Clear();

// إضافة سلسلة جديدة إلى الرسم البياني
ChartSeries series = chart.Series.Add("Aspose Series 1",
    new string[] { "Category 1", "Category 2", "Category 3" },
    new double[] { 2.7, 3.2, 0.8 });

توضيح

في هذه الخطوة، نتأكد من أن الرسم البياني الخاص بنا فارغ من خلال مسح أي سلسلة موجودة مسبقًا. ثم نضيف سلسلة جديدة بفئات وقيم مخصصة، والتي سيتم عرضها في الرسم البياني الدائري الخاص بنا.

الخطوة 4: تعيين الخيارات الافتراضية لعلامات البيانات

تعتبر تسميات البيانات ضرورية لجعل مخططك مفيدًا. سنقوم بتعيين خيارات لعرض النسبة المئوية والقيمة وتخصيص الفاصل.

// الوصول إلى مجموعة تسميات البيانات
ChartDataLabelCollection labels = series.DataLabels;

// تعيين خيارات تسمية البيانات
labels.ShowPercentage = true;
labels.ShowValue = true;
labels.ShowLeaderLines = false;
labels.Separator = " - ";

توضيح

هنا، نقوم بالوصول إلىDataLabelsخاصية سلسلتنا لتخصيص المظهر والمعلومات المعروضة على كل تسمية بيانات. لقد اخترنا إظهار النسبة المئوية والقيمة، وإخفاء خطوط القيادة، وتعيين فاصل مخصص.

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

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

// حفظ المستند
doc.Save(dataDir + "WorkingWithCharts.DefaultOptionsForDataLabels.docx");

توضيح

في هذه الخطوة الأخيرة، نقوم بحفظ مستندنا باستخدامSave الطريقة. سيتم حفظ المستند في الدليل المحدد بواسطةdataDir، باسم “WorkingWithCharts.DefaultOptionsForDataLabels.docx”.

خاتمة

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

لا تتردد في استكشافتوثيق Aspose.Words لمزيد من الميزات والأمثلة. استمتع بالبرمجة!

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

هل يمكنني استخدام Aspose.Words مجانًا؟

يمكنك استخدام Aspose.Words مجانًا معرخصة مؤقتة أو استكشف ميزاته باستخدامنسخة تجريبية مجانية.

كيف أحصل على الدعم لـ Aspose.Words؟

يمكنك الحصول على الدعم من خلالمنتدى دعم Aspose.Words.

هل يمكنني إضافة أنواع أخرى من الرسوم البيانية؟

نعم، يدعم Aspose.Words أنواعًا مختلفة من المخططات مثل المخططات الشريطية والخطية والعمودية. تحقق منالتوثيق لمزيد من التفاصيل.

هل Aspose.Words متوافق مع .NET Core؟

نعم، Aspose.Words متوافق مع .NET Core. يمكنك العثور على مزيد من المعلومات فيالتوثيق.

كيف يمكنني شراء ترخيص لـ Aspose.Words؟

يمكنك شراء ترخيص منمتجر اسبوس.