إنشاء عروض تقديمية في Node.js عبر .NET

نظرة عامة

يوضح هذا المقال كيفية إنشاء عرض تقديمي باستخدام Aspose.Slides لـ Node.js عبر .NET، وإضافة مربع نص إلى الشريحة الأولى، وحفظ النتيجة كملف PPTX. كما يوضح كيفية إضافة المزيد من الشرائح وكيفية تحويل العرض إلى شرائح widescreen (16:9).

تحتاج الأمثلة إلى إعداد مشروع كما هو موضح في Installation. احفظ كل مثال كملف .js في مجلد المشروع وشغله من ذلك المجلد باستخدام node، على سبيل المثال node create-presentation.js.

إنشاء عرض تقديمي مع مربع نص

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

  1. أنشئ مثيلاً من فئة Presentation. يحتوي العرض الجديد بالفعل على شريحة فارغة واحدة.
  2. احصل على تلك الشريحة من مجموعة slides. تُقرأ المجموعات في هذه الحزمة باستخدام get(index)، وتبدأ الفهارس من 0.
  3. أضف مستطيلاً باستخدام طريقة addAutoShape واضبط text الخاص بـ textFrame.
  4. احفظ العرض باستخدام طريقة save والقيمة SaveFormat.Pptx.
  5. استدعِ dispose داخل كتلة finally لتحرير موارد .NET التي تدعم العرض.
const { Presentation, ShapeType, SaveFormat } = require("aspose.slides.via.net");

const presentation = new Presentation();
try {
    const slide = presentation.slides.get(0);

    // الموضع (x, y) والحجم (العرض, الارتفاع) بوحدات النقاط.
    const textBox = slide.shapes.addAutoShape(ShapeType.Rectangle, 50, 50, 400, 100);
    textBox.textFrame.text = "Hello, Aspose.Slides!";

    presentation.save("new-presentation.pptx", SaveFormat.Pptx);
    console.log("Saved new-presentation.pptx");
} finally {
    presentation.dispose();
}

يكتب السكربت new-presentation.pptx إلى مجلد المشروع. يحتوي الملف على شريحة واحدة بها مستطيل مملوء تكون زاويةه العليا اليسرى على بعد 50 نقطة من الحواف اليسرى والعلوية للشريحة. عرض المستطيل 400 نقطة وارتفاعه 100 نقطة، ونصه مركّز. النقطة الواحدة تعادل 1/72 بوصة. بدون ترخيص، يضيف Aspose.Slides علامة مائية للتقييم إلى الشريحة؛ راجع Licensing.

إضافة شرائح

يحتوي العرض الجديد على شريحة واحدة. لإضافة المزيد، مرّر شريحة تخطيط إلى طريقة addEmptySlide لمجموعة slides. تُعيد طريقة getByType لمجموعة layoutSlides أول تخطيط من نوع معين من SlideLayoutType.

المثال التالي يضيف شريحتين بتخطيط Blank:

const { Presentation, SlideLayoutType, SaveFormat } = require("aspose.slides.via.net");

const presentation = new Presentation();
try {
    const blankLayout = presentation.layoutSlides.getByType(SlideLayoutType.Blank);
    presentation.slides.addEmptySlide(blankLayout);
    presentation.slides.addEmptySlide(blankLayout);

    console.log("Slide count: " + presentation.slides.count);
    presentation.save("three-slides.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

تطبع السكربت Slide count: 3 وتكتب three-slides.pptx. تُضاف الشرائح الجديدة بعد الأولى ولا تحتوي على أي أشكال. يحتوي العرض الجديد دائمًا على تخطيط Blank، لكن العرض الذي تفتحه من ملف قد لا يحتوي على تخطيط من النوع المطلوب؛ في هذه الحالة تُعيد getByType القيمة null، لذا تحقق من النتيجة قبل تمريرها.

تعيين حجم الشريحة

يستخدم العرض الجديد شرائح بنسبة 4:3 بحجم 720 × 540 نقطة (10 × 7.5 بوصة). لإنشاء شرائح widescreen بدلاً من ذلك، استدعِ طريقة setSize لخاصية slideSize في العرض مع قيمة من نوع SlideSizeType وقيمة من نوع SlideSizeScaleType. تُحدد نوعية المقياس ما يجب على Aspose.Slides القيام به مع الأشكال الموجودة بالفعل على الشرائح؛ DoNotScale يتركها كما هي، وهو الاختيار الصحيح لعرض لا يحتوي على محتوى بعد.

const { Presentation, SlideSizeType, SlideSizeScaleType, SaveFormat } = require("aspose.slides.via.net");

const presentation = new Presentation();
try {
    presentation.slideSize.setSize(SlideSizeType.Widescreen, SlideSizeScaleType.DoNotScale);

    const slideSize = presentation.slideSize.size;
    console.log(`Slide size: ${slideSize.width} x ${slideSize.height} points`);

    presentation.save("widescreen.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

تطبع السكربت Slide size: 960 x 540 points، وهو ما يعادل 13.33 × 7.5 بوصة، وتكتب widescreen.pptx. يمتلك SlideSizeType.OnScreen16x9 نفس نسبة العرض إلى الارتفاع 16:9 ولكنه أصغر: 720 × 405 نقطة.

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

ما هي الوحدات التي تُقاس بها المواضع والأحجام؟
بالنقاط. البوصة الواحدة تساوي 72 نقطة، لذا فإن الشريحة الافتراضية 4:3 هي 720 × 540 نقطة، وشريحة widescreen 16:9 هي 960 × 540 نقطة.

ما الصيغ التي يمكنني حفظ عرض تقديمي جديد بها؟
أي قيمة من تعداد SaveFormat، على سبيل المثال SaveFormat.Ppt لبرنامج PowerPoint 97–2003، SaveFormat.Odp لملف OpenDocument، أو SaveFormat.Pdf. للحصول على إخراج PDF، راجع Convert PowerPoint to PDF.

لماذا يحتوي العرض المحفوظ على النص “Evaluation only”؟
بدون ترخيص، يضيف Aspose.Slides علامة مائية للتقييم إلى الشرائح التي يحفظها. قم بتطبيق ترخيص كما هو موضح في Licensing لإزالتها.

لماذا يجب علي استدعاء dispose؟
كائن Presentation مدعوم بكيان .NET يحتفظ بالذاكرة وغيرها من الموارد. استدعاء dispose يحرّرها بمجرد عدم حاجتك للعرض، واستدعاؤه داخل كتلة finally يحرّرها حتى في حال حدوث خطأ.

فتح العروض في Node.js عبر .NET