الوصول إلى الشريحة في العرض التقديمي

تتيح لك Aspose.Slides الوصول إلى الشرائح بطريقتين: من خلال الفهرس ومن خلال المعرف.

الوصول إلى الشريحة من خلال الفهرس

تُرتب جميع الشرائح في العرض التقديمي رقميًا بناءً على موضع الشريحة بدءًا من 0. يمكن الوصول إلى الشريحة الأولى من خلال الفهرس 0؛ ويتم الوصول إلى الشريحة الثانية من خلال الفهرس 1؛ وهكذا.

تقوم فئة Presentation، الممثلة لملف العرض التقديمي، بتعريض جميع الشرائح كمجموعة ISlideCollection (مجموعة من كائنات ISlide). يُظهر لك هذا الكود في Java كيفية الوصول إلى شريحة من خلال الفهرس الخاص بها:

// ينشئ كائن Presentation يمثل ملف عرض تقديمي
Presentation pres = new Presentation("demo.pptx");
try {
    // يصل إلى شريحة باستخدام فهرس الشريحة
    ISlide slide = pres.getSlides().get_Item(0);
} finally {
    pres.dispose();
}

الوصول إلى الشريحة من خلال المعرف

كل شريحة في العرض التقديمي لديها معرف فريد مرتبط بها. يمكنك استخدام طريقة getSlideById (التي تعرضها فئة Presentation) لاستهداف هذا المعرف. يُظهر لك هذا الكود في Java كيفية توفير معرف شريحة صالح والوصول إلى هذه الشريحة من خلال طريقة getSlideById:

// ينشئ كائن Presentation يمثل ملف عرض تقديمي
Presentation pres = new Presentation("demo.pptx");
try {
    // يحصل على معرف الشريحة
    int id = (int) pres.getSlides().get_Item(0).getSlideId();
    
    // يصل إلى الشريحة من خلال المعرف الخاص بها
    IBaseSlide slide = pres.getSlideById(id);
} finally {
    pres.dispose();
}

تغيير موضع الشريحة

تتيح لك Aspose.Slides تغيير موضع الشريحة. على سبيل المثال، يمكنك تحديد أن الشريحة الأولى يجب أن تصبح الشريحة الثانية.

1. أنشئ مثيلًا من فئة Presentation.
2. احصل على مرجع الشريحة (التي تريد تغيير موضعها) من خلال فهرسها.
3. عيّن موضعًا جديدًا للشريحة من خلال خاصية setSlideNumber.
4. احفظ العرض التقديمي المعدل.

يُظهر لك هذا الكود في Java عملية يتم فيها نقل الشريحة الموجودة في الموضع 1 إلى الموضع 2:

// ينشئ كائن Presentation يمثل ملف عرض تقديمي
Presentation pres = new Presentation("Presentation.pptx");
try {
    // يحصل على الشريحة التي سيتم تغيير موضعها
    ISlide sld = pres.getSlides().get_Item(0);
    
    // يعين الموضع الجديد للشريحة
    sld.setSlideNumber(2);
    
    // يحفظ العرض التقديمي المعدل
    pres.save("helloworld_Pos.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

أصبحت الشريحة الأولى هي الشريحة الثانية؛ وأصبحت الشريحة الثانية هي الشريحة الأولى. عند تغيير موضع الشريحة، يتم ضبط الشرائح الأخرى تلقائيًا.

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

باستخدام خاصية setFirstSlideNumber (التي تعرضها فئة Presentation)، يمكنك تحديد رقم جديد للشريحة الأولى في العرض التقديمي. تتسبب هذه العملية في إعادة حساب أرقام الشرائح الأخرى.

1. أنشئ مثيلًا من فئة Presentation.
2. احصل على رقم الشريحة.
3. عيّن رقم الشريحة.
4. احفظ العرض التقديمي المعدل.

يُظهر لك هذا الكود في Java عملية حيث يتم تعيين رقم الشريحة الأولى إلى 10:

// ينشئ كائن Presentation يمثل ملف عرض تقديمي
Presentation pres = new Presentation("HelloWorld.pptx");
try {
    // يحصل على رقم الشريحة
    int firstSlideNumber = pres.getFirstSlideNumber();

    // يعين رقم الشريحة
    pres.setFirstSlideNumber(10);
	
    // يحفظ العرض التقديمي المعدل
    pres.save("Set_Slide_Number_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

إذا كنت تفضل تخطي الشريحة الأولى، يمكنك بدء الترقيم من الشريحة الثانية (وإخفاء الترقيم للشريحة الأولى) بهذه الطريقة:

Presentation presentation = new Presentation();
try {
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);
    presentation.getSlides().addEmptySlide(layoutSlide);
    presentation.getSlides().addEmptySlide(layoutSlide);
    presentation.getSlides().addEmptySlide(layoutSlide);

    // يعين الرقم للشريحة الأولى في العرض التقديمي
    presentation.setFirstSlideNumber(0);

    // يظهر أرقام الشرائح لجميع الشرائح
    presentation.getHeaderFooterManager().setAllSlideNumbersVisibility(true);

    // يخفي رقم الشريحة للشريحة الأولى
    presentation.getSlides().get_Item(0).getHeaderFooterManager().setSlideNumberVisibility(false);

    // يحفظ العرض التقديمي المعدل
    presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}