استخراج النص من Gear Type Smart Art في Excel

مقدمة

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

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

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

بيئة .NET

تأكد من إعداد بيئة تطوير .NET على جهاز الكمبيوتر لديك. يمكن أن تكون هذه البيئة عبارة عن Visual Studio أو أي بيئة تطوير متكاملة من اختيارك تدعم تطوير .NET.

Aspose.Cells لـ .NET

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

المعرفة الأساسية بلغة C#

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

عينة من ملف Excel

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

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

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

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

  1. افتح .NET IDE الخاص بك.
  2. قم بإنشاء مشروع جديد. على سبيل المثال، حدد “تطبيق وحدة التحكم” ضمن خيارات .NET.
  3. أعط مشروعك اسمًا وحدد الإطار المطلوب.

إضافة المراجع

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

  1. انقر بزر الماوس الأيمن على اسم مشروعك في مستكشف الحلول.
  2. اختر “إدارة حزم NuGet”.
  3. ابحث عن “Aspose.Cells” وقم بتثبيته. بمجرد التثبيت، ستكون جاهزًا تمامًا للترميز!
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

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

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

ابدأ بتحديد الدليل الذي يوجد به ملف Excel الخاص بك:

// دليل المصدر
string sourceDir = "Your Document Directory";

تأكد من الاستبدال"Your Document Directory" مع المسار الفعلي لملف Excel الخاص بك.

الخطوة 2: تحميل مصنف Excel

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

// قم بتحميل ملف Excel النموذجي الذي يحتوي على شكل الفن الذكي من نوع الترس.
Workbook wb = new Workbook(sourceDir + "sampleExtractTextFromGearTypeSmartArtShape.xlsx");

ستقوم هذه القطعة بتحميل مصنف Excel الخاص بك.

الخطوة 3: الوصول إلى ورقة العمل الأولى

الآن بعد أن قمنا بتحميل المصنف، فلننتقل إلى ورقة العمل الأولى التي يوجد بها SmartArt الخاص بنا:

// الوصول إلى ورقة العمل الأولى.
Worksheet ws = wb.Worksheets[0];

يؤدي هذا إلى استرجاع ورقة العمل الأولى لمزيد من المعالجة.

الخطوة 4: الوصول إلى الشكل الأول

بعد ذلك، نحتاج إلى الوصول إلى الشكل الأول داخل ورقة العمل الخاصة بنا. ومن خلال القيام بذلك، يمكننا التنقل عبر رسومات SmartArt الخاصة بنا:

// الوصول إلى الشكل الأول.
Aspose.Cells.Drawing.Shape sh = ws.Shapes[0];

هنا، نركز على الشكل الأول، والذي نفترض أنه SmartArt الذي نحتاجه.

الخطوة 5: الحصول على شكل المجموعة

بمجرد حصولنا على الشكل الذي نريده، حان الوقت للحصول على نتيجة تمثيل SmartArt الخاص بنا:

// احصل على نتيجة شكل الفن الذكي لنوع الترس في شكل شكل المجموعة.
Aspose.Cells.Drawing.GroupShape gs = sh.GetResultOfSmartArt();

يؤدي هذا إلى استرداد SmartArt من نوع التروس الخاص بنا كشكل مجمع.

الخطوة 6: استخراج الأشكال الفردية

الآن، دعنا نستخرج الأشكال الفردية التي تشكل رسم SmartArt الخاص بنا:

// احصل على قائمة الأشكال الفردية المكونة من شكل المجموعة.
Aspose.Cells.Drawing.Shape[] shps = gs.GetGroupedShapes();

ستحتوي هذه المجموعة على جميع الأشكال الفردية التي نحتاج إلى المرور عليها.

الخطوة 7: استخراج النص وطباعته

أخيرًا، يمكننا المرور عبر مجموعة الأشكال لدينا واستخراج النص من أي شكل من أشكال الترس:

// قم باستخراج نص أشكال نوع الترس وطباعتها على وحدة التحكم.
for (int i = 0; i < shps.Length; i++)
{
    Aspose.Cells.Drawing.Shape s = shps[i];
    if (s.Type == Aspose.Cells.Drawing.AutoShapeType.Gear9 || s.Type == Aspose.Cells.Drawing.AutoShapeType.Gear6)
    {
        Console.WriteLine("Gear Type Shape Text: " + s.Text);
    }
}

في هذه الحلقة، نتحقق من نوع الشكل ونطبع النص إذا كان شكلًا من نوع الترس.

الخطوة 8: تأكيد التنفيذ

أخيرًا، قد ترغب في إضافة رسالة تأكيد بمجرد اكتمال العملية بنجاح:

Console.WriteLine("ExtractTextFromGearTypeSmartArtShape executed successfully.");

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

خاتمة

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

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

ما هو Aspose.Cells؟

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

هل يمكنني استخدام Aspose.Cells مع لغات أخرى؟

نعم! Aspose.Cells متاح بالعديد من لغات البرمجة، بما في ذلك Java وPython.

هل أحتاج إلى شراء Aspose.Cells لـ .NET؟

يقدم Aspose.Cells نسخة تجريبية مجانية، ولكن للاستخدام الممتد، يلزم الشراء. يمكنك العثور على خيارات الشراءهنا.

هل هناك دعم متاح لمستخدمي Aspose.Cells؟

بالتأكيد! يمكنك العثور على دعم المجتمع فيمنتدى Aspose.Cells.

هل يمكنني استخراج أنواع أخرى من SmartArt باستخدام هذه الطريقة؟

نعم، مع إجراء تعديلات طفيفة، يمكنك استخراج النص من أشكال SmartArt المختلفة عن طريق تغيير الشروط في الكود الخاص بك.

استبدال العلامة بالنص في مربع النص في Excel