إضافة شكل بيضاوي إلى ورقة العمل في Excel
مقدمة
إن إنشاء ملفات Excel مذهلة وتفاعلية قد يتضمن أكثر من مجرد أرقام وصيغ. فالأشكال مثل الأشكال البيضاوية قد تضيف جاذبية بصرية أو توفر عناصر وظيفية في أوراق العمل الخاصة بك. في هذا البرنامج التعليمي، سنستكشف كيفية استخدام Aspose.Cells for .NET لإضافة أشكال بيضاوية إلى ورقة عمل Excel برمجيًا. سواء كنت تبحث عن إضافة بعض الأناقة أو الوظائف، فلدينا دليل خطوة بخطوة يوضح كل شيء.
المتطلبات الأساسية
قبل الغوص في الكود، هناك بعض الأشياء التي تحتاج إلى وضعها في مكانها:
- مكتبة Aspose.Cells لـ .NET: يمكنك تنزيلها منهنا أو قم بتثبيته باستخدام NuGet في Visual Studio.
- بيئة التطوير: AC# IDE مثل Visual Studio.
- الفهم الأساسي للغة C#: يجب أن تكون على دراية بمفاهيم الترميز الأساسية في لغة C#. تذكر أيضًا إعداد مشروعك عن طريق تثبيت مكتبة Aspose.Cells for .NET. إذا لم يكن لديك ترخيص بعد، فيمكنك التقدم بطلب للحصول على ترخيص.رخصة مؤقتة أو استخدمنسخة تجريبية مجانية إصدار.
استيراد الحزم
قبل كتابة أي كود، تأكد من تضمين مساحات الأسماء المطلوبة. إليك مقتطف الكود بلغة C# للتأكد من استخدامك للمكتبات الصحيحة:
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using System.Drawing;
الخطوة 1: إعداد الدليل الخاص بك
الخطوة الأولى لإضافة شكل بيضاوي إلى ورقة Excel هي تحديد المكان الذي سيتم حفظ ملف Excel فيه. دعنا نحدد مسار الدليل ونتأكد من وجود الدليل قبل حفظ عملنا.
سنقوم بإنشاء مسار الدليل والتحقق من وجوده. إذا لم يكن المجلد موجودًا، فسيتم إنشاؤه.
// المسار إلى دليل المستندات.
string dataDir = "Your Document Directory";
// إنشاء الدليل إذا لم يكن موجودًا بالفعل.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
System.IO.Directory.CreateDirectory(dataDir);
تعتبر هذه الخطوة بالغة الأهمية لأنها تضمن حفظ ملفك في الموقع المناسب، وعدم مواجهة مشكلات مسار الملف لاحقًا.
الخطوة 2: تهيئة مصنف جديد
بعد ذلك، نحتاج إلى إنشاء مصنف جديد نضيف فيه الأشكال البيضاوية. يمثل المصنف ملف Excel، ويمكننا إضافة محتوى أو أشكال إليه.
في هذه الخطوة، نقوم بإنشاء مثيل جديدWorkbook الكائن الذي سيعمل كحاوية لملف Excel الخاص بنا.
// إنشاء مصنف جديد.
Workbook excelbook = new Workbook();
الخطوة 3: أضف الشكل البيضاوي الأول
الآن يأتي الجزء الممتع - إضافة شكل بيضاوي إلى ورقة العمل. يمكن أن يمثل هذا الشكل البيضاوي عنصرًا مرئيًا مثل زر أو تمييز. سنبدأ بإضافة الشكل البيضاوي الأول إلى ورقة العمل الأولى في مصنفنا.
هنا نستخدمShapes.AddOval() طريقة إنشاء شكل بيضاوي على ورقة العمل في صف وعمود محددين.
// أضف شكلًا بيضاويًا.
Aspose.Cells.Drawing.Oval oval1 = excelbook.Worksheets[0].Shapes.AddOval(2, 0, 2, 0, 130, 160);
المعلمات بالداخلAddOval() هي كما يلي:
- الرقمان الأولان يمثلان الصف والعمود للزاوية العلوية اليسرى من الشكل البيضاوي.
- الرقمان التاليان يمثلان ارتفاع وعرض الشكل البيضاوي.
الخطوة 4: تعيين موضع الشكل البيضاوي ونمطه
بمجرد إنشاء الشكل البيضاوي، يمكننا ضبط موضعه ووزن الخط ونمط الشرطة.Placement تحدد الخاصية كيفية تصرف الشكل البيضاوي عند تغيير حجم الخلايا أو نقلها في ورقة العمل.
نجعل الشكل البيضاوي عائمًا حرًا ونعدل مظهره.
// ضبط موضع البيضاوي.
oval1.Placement = PlacementType.FreeFloating;
// ضبط وزن الخط.
oval1.Line.Weight = 1;
// تعيين نمط الشرطة للشكل البيضاوي.
oval1.Line.DashStyle = MsoLineDashStyle.Solid;
يتيح هذا للشكل البيضاوي التحرك بحرية داخل ورقة العمل، كما يتم ضبط وزن الخط ونمطه لتحقيق الاتساق البصري.
الخطوة 5: أضف شكلًا بيضاويًا (دائريًا) آخر
لماذا نتوقف عند شكل واحد؟ في هذه الخطوة، سنضيف شكلًا بيضاويًا آخر، وهذه المرة سننشئ دائرة مثالية عن طريق جعل الارتفاع والعرض متساويين.
نقوم بإنشاء شكل بيضاوي آخر، ونضعه في مكان مختلف، ونتأكد من أنه ذو شكل دائري من خلال تحديد الارتفاع والعرض بشكل متساوي.
// أضف شكلًا بيضاويًا (دائريًا) آخر.
Aspose.Cells.Drawing.Oval oval2 = excelbook.Worksheets[0].Shapes.AddOval(9, 0, 2, 15, 130, 130);
الخطوة 6: تصميم الشكل البيضاوي الثاني
تمامًا كما في السابق، سنقوم بتعديل الموضع والوزن ونمط الشرطة لهذا الشكل البيضاوي الثاني (أو الدائرة).
نطبق خصائص مماثلة على الشكل البيضاوي الثاني لتتناسب مع أسلوب الشكل البيضاوي الأول.
// ضبط موضع البيضاوي.
oval2.Placement = PlacementType.FreeFloating;
// ضبط وزن الخط.
oval2.Line.Weight = 1;
// تعيين نمط الشرطة للشكل البيضاوي.
oval2.Line.DashStyle = MsoLineDashStyle.Solid;
الخطوة 7: احفظ المصنف
أخيرًا، نحتاج إلى حفظ المصنف الذي يحتوي على الأشكال البيضاوية التي أضفناها للتو. يضمن حفظ الملف تخزين كل التغييرات التي أجريناها.
نقوم بحفظ المصنف في مسار الدليل الذي حددناه سابقًا.
// احفظ ملف Excel.
excelbook.Save(dataDir + "book1.out.xls");
وهذا كل شيء! لقد نجحت في إضافة الأشكال البيضاوية إلى ورقة عمل Excel وحفظت الملف.
خاتمة
إن إضافة أشكال مثل الأشكال البيضاوية إلى ورقة Excel باستخدام Aspose.Cells for .NET ليس بالأمر السهل فحسب، بل إنه أيضًا طريقة ممتعة لتعزيز جداول البيانات الخاصة بك بعناصر مرئية إضافية. سواء لأغراض التصميم أو إضافة عناصر قابلة للنقر، يمكن للأشكال أن تلعب دورًا مهمًا في شكل ملفات Excel ووظيفتها. لذا، في المرة القادمة التي تعمل فيها على مشروع يتطلب أوراق Excel تفاعلية أو جذابة بصريًا، فأنت تعرف بالضبط كيفية إضافة تلك الأشكال البيضاوية المثالية!
الأسئلة الشائعة
هل يمكنني إضافة أشكال أخرى مثل المستطيلات أو الخطوط باستخدام Aspose.Cells لـ .NET؟
نعم، يمكنك إضافة أشكال مختلفة مثل المستطيلات والخطوط والسهام باستخدامShapes المجموعة في Aspose.Cells.
هل من الممكن تغيير حجم البيضاوي بعد إضافتها؟
بالتأكيد! يمكنك تعديل خصائص الارتفاع والعرض للأشكال البيضاوية بعد إضافتها.
ما هي تنسيقات الملفات التي يمكنني حفظ المصنف بها بالإضافة إلى XLS؟
يدعم Aspose.Cells تنسيقات متعددة مثل XLSX وCSV وPDF وغيرها.
هل يمكنني تعديل لون مخطط الشكل البيضاوي؟
نعم، يمكنك تغيير لون خط البيضاوي باستخدامLine.Color ملكية.
هل من الضروري الحصول على ترخيص لـ Aspose.Cells؟
على الرغم من أنه يمكنك تجربة Aspose.Cells من خلال إصدار تجريبي مجاني، إلا أنك ستحتاج إلىرخصة للاستخدام طويل الأمد أو للوصول إلى الميزات المتقدمة.
