مكتبة C# .NET مجانية لتوليد PowerPoint PPTX من القالب

بدء الاستخدام مع PPTXTemplater

الطريقة الموصى بها لتثبيت PPTXTemplater هي باستخدام GitHub. يرجى استخدام الأمر التالي لتثبيت سلس.

 git clone https://github.com/tkrotoff/PptxTemplater.git

إنشاء ملفات PPTX مبنية على القوالب عبر C#

أساس PptxTemplater هو نهجه القائم على القوالب. تبدأ بإنشاء عرض تقديمي قياسي في PowerPoint سيعمل كقالب لك. في هذا القالب، يمكنك تعريف عناصر نائبة للمحتوى الديناميكي باستخدام بنية بسيطة وبديهية، عادةً {{placeholder_name}}. هذا يتيح لك تصميم الشرائح في PowerPoint نفسه، مما يمنحك السيطرة الكاملة على الجوانب البصرية لعرضك. إليك مثال بسيط يوضح كيفية إنشاء قالب PowerPoint يحتوي على شريحتين عبر مكتبة C#؟

const string srcFileName = "template.pptx";
const string dstFileName = "final.pptx";
File.Delete(dstFileName);
File.Copy(srcFileName, dstFileName);

Pptx pptx = new Pptx(dstFileName, FileAccess.ReadWrite);
int nbSlides = pptx.SlidesCount();
Assert.AreEqual(2, nbSlides);

// First slide
{
    PptxSlide slide = pptx.GetSlide(0);
    slide.ReplaceTag("{{hello}}", "HELLO HOW ARE YOU?", PptxSlide.ReplacementType.Global);
    slide.ReplaceTag("{{bonjour}}", "BONJOUR TOUT LE MONDE", PptxSlide.ReplacementType.Global);
    slide.ReplaceTag("{{hola}}", "HOLA MAMA QUE TAL?", PptxSlide.ReplacementType.Global);
}

// Second slide
{
    PptxSlide slide = pptx.GetSlide(1);
    slide.ReplaceTag("{{hello}}", "H", PptxSlide.ReplacementType.Global);
    slide.ReplaceTag("{{bonjour}}", "B", PptxSlide.ReplacementType.Global);
    slide.ReplaceTag("{{hola}}", "H", PptxSlide.ReplacementType.Global);
}

استبدال النص في عرض PPTX التقديمي عبر C#

إحدى أهم الميزات الأساسية في PptxTemplater هي قدرته على استبدال عناصر النص النائبة ببياناتك. هذا مفيد للغاية لتخصيص العروض التقديمية بالأسماء والتواريخ والأرقام وغيرها من المعلومات النصية. إليك مثالًا بسيطًا يوضح كيف يمكن لمطوري البرمجيات استبدال النص داخل عرض PPTX في تطبيقات C# .NET.

using PptxTemplater;

// Load the template
using (var presentation = new Presentation("template.pptx"))
{
    // Define the data
    var data = new Dictionary
    {
        { "name", "John Doe" },
        { "date", DateTime.Now.ToShortDateString() }
    };

    // Fill the template
    presentation.Fill(data);

    // Save the new presentation
    presentation.SaveAs("output.pptx");
}

استبدال الصور في عرض PPTX التقديمي عبر C#

مكتبة PptxTemplater مفتوحة المصدر لا تقتصر على النص فقط. يمكن لمطوري البرمجيات أيضًا استبدال الصور داخل القوالب ببضع أسطر من الشيفرة. هذا مفيد بشكل خاص لإنشاء كتالوجات المنتجات، بطاقات الموظفين، أو أي عرض تقديمي آخر يتطلب صورًا ديناميكية. إليك مثال بسيط يوضح كيفية استبدال الصور داخل عروض PPTX. لاستبدال صورة، تحتاج أولاً إلى إضافة صورة نائب في القالب وإعطائها اسمًا محددًا (مثال: \"photo1\").

// Assuming you have a slide with an image named "photo1"
var slide = presentation.Slides[0];
slide.ReplacePicture("photo1", "new_image.png");

إضافة، إزالة أو استنساخ شريحة عبر C#

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

/// Clone a slide
var newSlide = presentation.CloneSlide(0);

// Remove a slide
presentation.RemoveSlide(1);