الشريحة

يوفر هذا المقال سلسلة من الأمثلة التي توضح كيفية العمل مع الشرائح باستخدام Aspose.Slides for .NET. ستتعلم كيفية إضافة، الوصول إلى، استنساخ، إعادة ترتيب، وإزالة الشرائح باستخدام فئة Presentation.

يتضمن كل مثال أدناه شرحًا موجزًا يليه مقتطف شفرة بلغة C#.

إضافة شريحة

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

static void Add_Slide()
{
    using var pres = new Presentation();

    // كل شريحة مبنية على تخطيط، والذي بدوره مبني على شريحة رئيسية.
    // استخدم التخطيط Blank لإنشاء شريحة جديدة.
    var blankLayout = pres.LayoutSlides.GetByType(SlideLayoutType.Blank);

    // Add a new empty slide using the selected layout
    pres.Slides.AddEmptySlide(layout: blankLayout);
}

💡 Tip: Each slide layout is derived from a master slide, which defines the overall design and placeholder structure. The image below illustrates how master slides and their associated layouts are organized in PowerPoint.

Access Slides by Index

You can access slides using their index, or find a slide’s index based on a reference. This is useful for iterating through or modifying specific slides.

static void Access_Slide()
{
    // بشكل افتراضي، يتم إنشاء عرض تقديمي بشريحة فارغة واحدة.
    using var pres = new Presentation();

    // أضف شريحة فارغة أخرى
    pres.Slides.AddEmptySlide(layout: pres.LayoutSlides.GetByType(SlideLayoutType.Blank));

    // الوصول إلى الشرائح حسب الفهرس
    var firstSlide = pres.Slides[0];
    var secondSlide = pres.Slides[1];

    // احصل على فهرس الشريحة من مرجع، ثم وصول إليها حسب الفهرس
    var secondSlideIndex = pres.Slides.IndexOf(secondSlide);
    var secondSlideByIndex = pres.Slides[secondSlideIndex];
}

Clone a Slide

This example demonstrates how to clone an existing slide. The cloned slide is automatically added to the end of the slide collection.

static void Clone_Slide()
{
    // بشكل افتراضي، يحتوي العرض التقديمي على شريحة فارغة واحدة.
    using var pres = new Presentation();

    // استنساخ الشريحة الأولى؛ ستُضاف في نهاية العرض التقديمي
    var clonedSlide = pres.Slides.AddClone(sourceSlide: pres.Slides[0]);

    // فهرس الشريحة المستنسخة هو 1 (الشريحة الثانية في العرض التقديمي)
    var clonedSlideIndex = pres.Slides.IndexOf(clonedSlide);
}

Reorder Slides

You can change the order of slides by moving one to a new index. In this case, we move a cloned slide to the first position.

static void ReOrder_Slide()
{
    using var pres = new Presentation();

    // أضف نسخة مستنسخة من الشريحة الأولى (التي تم إنشاؤها بشكل افتراضي)
    var clonedSlide = pres.Slides.AddClone(pres.Slides[0]);

    // Move the cloned slide to the first position (others shift down)
    pres.Slides.Reorder(index: 0, clonedSlide);
}

Remove a Slide

To remove a slide, simply reference it and call Remove. This example adds a second slide and then removes the original, leaving only the new one.

static void Remove_Slide()
{
    using var pres = new Presentation();

    // أضف شريحة فارغة جديدة إضافةً إلى الشريحة الأولى الافتراضية
    var secondSlide = pres.Slides.AddEmptySlide(layout: pres.LayoutSlides.GetByType(SlideLayoutType.Blank));

    // إزالة الشريحة الأولى؛ سيبقى فقط الشريحة التي تم إضافتها حديثًا
    var firstSlide = pres.Slides[0];
    pres.Slides.Remove(firstSlide);
}