إضافة قوس إلى ورقة العمل في Excel

مقدمة

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

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

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

  1. Visual Studio: سوف تحتاج إلى تثبيت Visual Studio على جهاز الكمبيوتر الخاص بك لأننا سوف نستخدم C# كلغة برمجة.
  2. .NET Framework: تأكد من تثبيت .NET Framework أو .NET Core. يدعم Aspose.Cells كليهما.
  3. Aspose.Cells لـ .NET: يجب أن يكون لديك مكتبة Aspose.Cells. يمكنك تنزيلها منتنزيلات Aspose.Cells صفحة.
  4. الفهم الأساسي للغة C#: ستساعدك المعرفة بلغة C# على متابعة مقتطفات التعليمات البرمجية دون الكثير من المتاعب.

استيراد الحزم

للبدء في العمل باستخدام Aspose.Cells في مشروعك، تحتاج إلى استيراد الحزم اللازمة. وإليك كيفية القيام بذلك:

إنشاء مشروع جديد

  • افتح Visual Studio.
  • اختر “إنشاء مشروع جديد”.
  • حدد قالبًا يعمل مع .NET (مثل تطبيق وحدة التحكم).

إضافة مراجع Aspose.Cells

  • انقر بزر الماوس الأيمن على مشروعك في مستكشف الحلول.
  • حدد “إدارة حزم NuGet”.
  • ابحث عن “Aspose.Cells” وقم بتثبيته. أنت الآن جاهز لبدء برمجة إضافة القوس.
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using System.Drawing;

فيما يلي تفصيل خطوة بخطوة للكود الذي يوضح كيفية إضافة أقواس إلى ورقة عمل في Excel.

الخطوة 1: إعداد الدليل

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

string dataDir = "Your Document Directory";
// إنشاء الدليل إذا لم يكن موجودًا بالفعل.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

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

الخطوة 2: إنشاء مصنف

الآن، لنبدأ في إنشاء مثيل مصنف جديد.

// إنشاء مصنف جديد.
Workbook excelbook = new Workbook();

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

الخطوة 3: أضف شكل القوس الأول

الآن، دعونا نضيف شكل القوس الأول إلى ورقة العمل.

// أضف شكل قوس.
Aspose.Cells.Drawing.ArcShape arc1 = excelbook.Worksheets[0].Shapes.AddArc(2, 0, 2, 0, 130, 130);

هنا، نضيف قوسًا إلى ورقة العمل الأولى. تحدد المعلمات موضع القوس وحجمه:(left, top, width, height, startAngle, endAngle)إنه مثل رسم جزء من الدائرة!

الخطوة 4: تخصيص القوس الأول

بعد إضافة القوس، قد ترغب في تخصيص مظهره.

// تعيين لون شكل التعبئة
arc1.Fill.FillType = FillType.Solid;
arc1.Fill.SolidFill.Color = Color.Blue;
// ضبط موضع القوس.
arc1.Placement = PlacementType.FreeFloating;           
// ضبط وزن الخط.
arc1.Line.Weight = 1;      
// تعيين نمط الشرطة للقوس.
arc1.Line.DashStyle = MsoLineDashStyle.Solid;

في هذا القسم، نقوم بتخصيص القوس. نقوم بتعيين نوع التعبئة الخاص به إلى لون ثابت (أزرق في هذه الحالة)، ونحدد كيفية وضعه، ونحدد وزن الخط، ونختار نمط الشرطة. في الأساس، نقوم بتزيين القوس الخاص بنا لجعله جذابًا بصريًا!

الخطوة 5: إضافة شكل قوس ثانٍ

دعونا نضيف شكل قوس آخر لتوفير المزيد من السياق.

// أضف شكل قوس آخر.
Aspose.Cells.Drawing.ArcShape arc2 = excelbook.Worksheets[0].Shapes.AddArc(9, 0, 2, 0, 130, 130);

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

الخطوة 6: تخصيص القوس الثاني

تمامًا كما فعلنا مع القوس الأول، سنقوم بتخصيص القوس الثاني أيضًا.

// ضبط لون الخط
arc2.Line.FillType = FillType.Solid;
arc2.Line.SolidFill.Color = Color.Blue;
// ضبط موضع القوس.
arc2.Placement = PlacementType.FreeFloating;          
// ضبط وزن الخط.
arc2.Line.Weight = 1;           
// تعيين نمط الشرطة للقوس.
arc2.Line.DashStyle = MsoLineDashStyle.Solid;

هنا، نمنح القوس الثاني نفس التصميم مثل القوس الأول. يمكنك تغيير اللون أو التصميم حسب رغبتك لأغراض التفرد أو المواضيع.

الخطوة 7: احفظ المصنف

وأخيرًا، حان الوقت لحفظ مصنف العمل الذي قمت بإنشائه حديثًا باستخدام الأقواس.

// احفظ ملف Excel.
excelbook.Save(dataDir + "book1.out.xls");

يعمل هذا الخط مثل الضغط على زر الحفظ. فنحن نحفظ عملنا في الموقع المحدد باسم ملف معين. تأكد من مراجعة الدليل الخاص بك لرؤية تحفتك الفنية بتنسيق Excel!

خاتمة

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

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

ما هو Aspose.Cells؟

Aspose.Cells هي مكتبة قوية تسمح للمطورين بإنشاء ملفات Excel ومعالجتها وتحويلها برمجيًا دون الحاجة إلى Microsoft Excel.

هل أحتاج إلى تثبيت Microsoft Excel لاستخدام Aspose.Cells؟

لا، Aspose.Cells مستقل تمامًا ولا يتطلب تثبيت Microsoft Excel.

هل يمكنني تجربة Aspose.Cells مجانًا؟

نعم، يمكنك تجربة Aspose.Cells باستخدامنسخة تجريبية مجانية.

ما هي لغات البرمجة التي يدعمها Aspose.Cells؟

يدعم Aspose.Cells لغات متعددة، بما في ذلك C#، وVB.NET، والمزيد.

أين يمكنني الحصول على الدعم لـ Aspose.Cells؟

يمكنك الحصول على الدعم من خلالمنتدى اسبوس.

التعامل مع عناصر التحكم في مربع النص في Excel إضافة شكل بيضاوي إلى ورقة العمل في Excel