تحديد خصائص المحور X وY في الرسم البياني

مقدمة

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

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

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

  1. Aspose.Words for .NET: تأكد من أن لديك مكتبة Aspose.Words for .NET. يمكنكتحميله هنا.
  2. بيئة التطوير: تحتاج إلى بيئة تطوير متكاملة (IDE) مثل Visual Studio.
  3. .NET Framework: تأكد من إعداد بيئة التطوير الخاصة بك لتطوير .NET.
  4. المعرفة الأساسية بلغة C#: يفترض هذا الدليل أن لديك فهمًا أساسيًا لبرمجة C#.

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

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

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

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

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

أولاً، تحتاج إلى تهيئة مستند جديد وDocumentBuilder الكائن.DocumentBuilder يساعد في إدراج المحتوى في المستند.

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

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

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

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

// إدراج الرسم البياني
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

الخطوة 3: مسح السلسلة الافتراضية وإضافة بيانات مخصصة

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

chart.Series.Clear();
chart.Series.Add("Aspose Series 1",
	new DateTime[]
	{
		new DateTime(2002, 01, 01), new DateTime(2002, 06, 01), new DateTime(2002, 07, 01),
		new DateTime(2002, 08, 01), new DateTime(2002, 09, 01)
	},
	new double[] { 640, 320, 280, 120, 150 });

الخطوة 4: تحديد خصائص المحور X

الآن، حان الوقت لتحديد خصائص المحور X. ويتضمن ذلك تحديد نوع الفئة، وتخصيص تقاطع المحور، وضبط علامات التجزئة والعلامات.

ChartAxis xAxis = chart.AxisX;
xAxis.CategoryType = AxisCategoryType.Category;
xAxis.Crosses = AxisCrosses.Custom;
xAxis.CrossesAt = 3; // يتم قياسها بوحدات العرض لمحور Y (المئات).
xAxis.ReverseOrder = true;
xAxis.MajorTickMark = AxisTickMark.Cross;
xAxis.MinorTickMark = AxisTickMark.Outside;
xAxis.TickLabelOffset = 200;

الخطوة 5: تحديد خصائص المحور Y

وبالمثل، ستقوم بتعيين خصائص المحور Y. ويتضمن ذلك تعيين موضع علامة التجزئة، والوحدات الرئيسية والثانوية، ووحدة العرض، والقياس.

ChartAxis yAxis = chart.AxisY;
yAxis.TickLabelPosition = AxisTickLabelPosition.High;
yAxis.MajorUnit = 100;
yAxis.MinorUnit = 50;
yAxis.DisplayUnit.Unit = AxisBuiltInUnit.Hundreds;
yAxis.Scaling.Minimum = new AxisBound(100);
yAxis.Scaling.Maximum = new AxisBound(700);

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

أخيرًا، احفظ المستند في الدليل المحدد. سيؤدي هذا إلى إنشاء مستند Word بالمخطط المخصص.

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

خاتمة

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

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

ما هي أنواع المخططات البيانية التي يمكنني إنشاؤها باستخدام Aspose.Words لـ .NET؟

يمكنك إنشاء أنواع مختلفة من المخططات البيانية، بما في ذلك المخطط المساحية، والمخطط الشريطي، والمخطط الخطي، والمخطط الدائري، والمزيد.

كيف أقوم بتثبيت Aspose.Words لـ .NET؟

يمكنك تنزيل Aspose.Words لـ .NET منهناواتبع تعليمات التثبيت المقدمة.

هل يمكنني تخصيص مظهر الرسوم البيانية الخاصة بي؟

نعم، يسمح Aspose.Words for .NET بالتخصيص الشامل للمخططات، بما في ذلك الألوان والخطوط وخصائص المحور.

هل هناك نسخة تجريبية مجانية متاحة لـ Aspose.Words لـ .NET؟

نعم، يمكنك الحصول على نسخة تجريبية مجانيةهنا.

أين يمكنني العثور على المزيد من البرامج التعليمية والوثائق؟

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