استخراج النص المتقدم من العروض التقديمية في .NET

نظرة عامة

يُعد استخراج النص من العروض التقديمية مهمة شائعة ولكنها أساسية للمطورين الذين يتعاملون مع محتوى الشرائح. سواءً كنت تتعامل مع ملفات Microsoft PowerPoint بصيغة PPT أو PPTX، أو عروض OpenDocument (ODP)، فإن الوصول إلى البيانات النصية واسترجاعها يمكن أن يكون حيويًا للتحليل، أو الأتمتة، أو الفهرسة، أو أغراض ترحيل المحتوى.

تقدم هذه المقالة دليلًا شاملاً حول كيفية استخراج النص بفعالية من تنسيقات العرض المختلفة، بما في ذلك PPT وPPTX وODP، باستخدام Aspose.Slides for .NET. ستتعلم كيفية تكرار عناصر العرض بشكل منهجي لاسترجاع محتوى النص الدقيق الذي تحتاجه.

استخراج النص من شريحة

توفر Aspose.Slides for .NET مساحة الأسماء Aspose.Slides.Util التي تحتوي على الفئة SlideUtil. تُعرِّف هذه الفئة عدة طرق ثابتة محملّة (overloaded) لاستخراج جميع النصوص من عرض تقديمي أو شريحة. لاستخراج النص من شريحة في عرض تقديمي، استخدم الطريقة GetAllTextBoxes. تقبل هذه الطريقة كمعامل كائنًا من النوع ISlide. عند تنفيذها، تقوم الطريقة بمسح الشريحة بالكامل بحثًا عن النص وتعيد مصفوفة من الكائنات من النوع ITextFrame، مع الحفاظ على أي تنسيق للنص.

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

int slideIndex = 0;

// إنشاء كائن من الفئة Presentation التي تمثل ملف عرض تقديمي (PPT، PPTX، ODP، إلخ).
using Presentation presentation = new Presentation("demo.pptx");

// الحصول على مرجع إلى الشريحة.
ISlide slide = presentation.Slides[slideIndex];

// الحصول على مصفوفة من إطارات النص من الشريحة.
ITextFrame[] textFrames = Aspose.Slides.Util.SlideUtil.GetAllTextBoxes(slide);

// التكرار عبر مصفوفة إطارات النص.
for (int i = 0; i < textFrames.Length; i++)
{
    // التكرار عبر الفقرات في إطار النص الحالي.
    foreach (IParagraph paragraph in textFrames[i].Paragraphs)
    {
        // التكرار عبر أجزاء النص في الفقرة الحالية.
        foreach (IPortion portion in paragraph.Portions)
        {
            // عرض النص في جزء النص الحالي.
            Console.WriteLine(portion.Text);

            // عرض ارتفاع الخط للنص.
            Console.WriteLine(portion.PortionFormat.FontHeight);

            // عرض اسم الخط للنص.
            if (portion.PortionFormat.LatinFont != null)
                Console.WriteLine(portion.PortionFormat.LatinFont.FontName);
        }
    }
}

استخراج النص من عرض تقديمي

لمسح النص من العرض التقديمي بأكمله، استخدم الطريقة الثابتة GetAllTextFrames التي توفرها الفئة SlideUtil. تقبل هذه الطريقة معاملين:

  1. أولاً، كائن Presentation يمثل عرض PowerPoint أو OpenDocument سيتم استخراج النص منه.
  2. ثانياً، قيمة Boolean تحدد ما إذا كان يجب تضمين الشرائح الرئيسية عند مسح النص من العرض التقديمي.

تُعيد الطريقة مصفوفة من الكائنات من النوع ITextFrame، متضمنةً معلومات تنسيق النص. الشيفرة أدناه تمسح النص وتفاصيل التنسيق من عرض تقديمي، بما في ذلك الشرائح الرئيسية:

// إنشاء كائن من الفئة Presentation التي تمثل ملف عرض تقديمي (PPT، PPTX، ODP، إلخ).
using Presentation presentation = new Presentation("demo.pptx");

// الحصول على مصفوفة من إطارات النص من جميع الشرائح في العرض التقديمي.
ITextFrame[] textFrames = Aspose.Slides.Util.SlideUtil.GetAllTextFrames(presentation, true);

// التكرار عبر مصفوفة إطارات النص.
for (int i = 0; i < textFrames.Length; i++)
{
    // التكرار عبر الفقرات في إطار النص الحالي.
    foreach (IParagraph paragraph in textFrames[i].Paragraphs)
    {
        // التكرار عبر أجزاء النص في الفقرة الحالية.
        foreach (IPortion portion in paragraph.Portions)
        {
            // عرض النص في جزء النص الحالي.
            Console.WriteLine(portion.Text);

            // عرض ارتفاع الخط للنص.
            Console.WriteLine(portion.PortionFormat.FontHeight);

            // عرض اسم الخط للنص.
            if (portion.PortionFormat.LatinFont != null)
                Console.WriteLine(portion.PortionFormat.LatinFont.FontName);
        }
    }
}

استخراج النص المصنف والسريع

توفر الفئة PresentationFactory أيضًا طرقًا ثابتة لاستخراج جميع النصوص من العروض التقديمية:

IPresentationText GetPresentationText(string file, TextExtractionArrangingMode mode);
IPresentationText GetPresentationText(Stream stream, TextExtractionArrangingMode mode);
IPresentationText GetPresentationText(Stream stream, TextExtractionArrangingMode mode, ILoadOptions options);

معامل تعداد TextExtractionArrangingMode يشير إلى وضع تنظيم نتيجة استخراج النص ويمكن ضبطه على القيم التالية:

  • Unarranged - النص الخام دون النظر إلى موقعه على الشريحة.
  • Arranged - يُرتّب النص بنفس الترتيب الموجود على الشريحة.

يمكن استخدام وضع Unarranged عندما يكون السرعة أمرًا حاسمًا؛ فهو أسرع من وضع Arranged.

الواجهة IPresentationText تمثل النص الخام المستخرج من العرض التقديمي. تحتوي على الخاصية SlidesText من مساحة الأسماء Aspose.Slides.Util، والتي تُعيد مصفوفة من الكائنات من النوع ISlideText. يمثل كل كائن النص الموجود على الشريحة المقابلة. يحتوي كائن النوع ISlideText على الخصائص التالية:

  • Text - النص داخل أشكال الشريحة.
  • MasterText - النص داخل أشكال الشريحة الرئيسية المرتبطة بهذه الشريحة.
  • LayoutText - النص داخل أشكال شريحة التخطيط المرتبطة بهذه الشريحة.
  • NotesText - النص داخل أشكال شريحة الملاحظات المرتبطة بهذه الشريحة.
  • CommentsText - النص داخل التعليقات المرتبطة بهذه الشريحة.
IPresentationText text = new PresentationFactory().GetPresentationText("presentation.ppt", TextExtractionArrangingMode.Unarranged);
Console.WriteLine(text.SlidesText[0].Text);
Console.WriteLine(text.SlidesText[0].LayoutText);
Console.WriteLine(text.SlidesText[0].MasterText);
Console.WriteLine(text.SlidesText[0].NotesText);
Console.WriteLine(text.SlidesText[0].CommentsText);

الأسئلة المتكررة

ما مدى سرعة معالجة Aspose.Slides للعروض التقديمية الكبيرة أثناء استخراج النص؟

تم تحسين Aspose.Slides للأداء العالي ويعالج العروض الكبيرة بكفاءة، مما يجعله مناسبًا للسيناريوهات الوقت الحقيقي أو المعالجة الضخمة.

هل يمكن لـ Aspose.Slides استخراج النص من الجداول والرسوم البيانية داخل العروض التقديمية؟

نعم، يدعم Aspose.Slides استخراج النص من الجداول والرسوم البيانية والعناصر المعقدة الأخرى في الشرائح، مما يتيح لك الوصول إلى جميع المحتويات النصية وتحليلها بسهولة.

هل أحتاج إلى ترخيص خاص من Aspose.Slides لاستخراج النص من العروض التقديمية؟

يمكنك استخراج النص باستخدام النسخة التجريبية المجانية من Aspose.Slides، رغم أنها ستفرض بعض القيود مثل معالجة عدد محدود من الشرائح. للحصول على استخدام غير مقيد ومعالجة عروض تقديمية أكبر، يُنصح بشراء ترخيص كامل.

إدارة النص المرتفع والنص المنخفض في العروض التقديمية في .NET أتمتة تعريب العروض التقديمية في .NET