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

مقدمة

مرحبًا يا من هناك! هل أنت متحمس للغوص في عالم أتمتة المستندات؟ سنستكشف اليوم كيفية استخدام Aspose.Words for .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 يوفر class مجموعة من الطرق لمعالجة محتوى المستند بسهولة.

// المسار إلى دليل المستندات الخاص بك
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 لـ .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؟

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