InsertClone()

SlideCollection::InsertClone(int32_t, System::SharedPtr<ISlide>) method

Inserts a copy of a specified slide to specified position of the collection.

System::SharedPtr<ISlide> Aspose::Slides::SlideCollection::InsertClone(int32_t index, System::SharedPtr<ISlide> sourceSlide) override

Arguments

ParameterTypeDescription
indexint32_tIndex of new slide.
sourceSlideSystem::SharedPtr<ISlide>Slide to clone.

Return Value

Inserted slide.

Remarks

When cloning a slide between different presentations slide’s master can be cloned too. Internal registry is used to track automatically cloned masters to prevent creation of multiple clones of the same master slide. Manual cloning of master slides will be neither prevented nor registered. If you need more control over cloning process use InsertClone(int32_t, SharedPtr, SharedPtr) or InsertClone(int32_t, SharedPtr, SharedPtr, bool) for cloning slides and IMasterSlideCollection::AddClone(SharedPtr) for cloning masters.

The following example shows how to clone at another position within Presentation.

// Instantiate Presentation class that represents a presentation file
auto pres = System::MakeObject<Presentation>(u"CloneWithInSamePresentation.pptx");

// Clone the desired slide to the end of the collection of slides in the same presentation
System::SharedPtr<ISlideCollection> slides = pres->get_Slides();
// Clone the desired slide to the specified index in the same presentation
slides->InsertClone(2, slides->idx_get(1));
// Write the modified presentation to disk
pres->Save(u"Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat::Pptx);

The following example shows how to clone at another position within Presentation.

// Instantiate Presentation class to load the source presentation file
auto srcPres = System::MakeObject<Presentation>(u"CloneAtEndOfAnother.pptx");

// Instantiate Presentation class for destination PPTX (where slide is to be cloned)
auto destPres = System::MakeObject<Presentation>();

destPres->get_Slides()->InsertClone(2, srcPres->get_Slides()->idx_get(0));
// Write the destination presentation to disk
destPres->Save(u"Aspose2_out.pptx", SaveFormat::Pptx);

SlideCollection::InsertClone(int32_t, System::SharedPtr<ISlide>, System::SharedPtr<ILayoutSlide>) method

Inserts a copy of a specified slide to specified position of the collection.

System::SharedPtr<ISlide> Aspose::Slides::SlideCollection::InsertClone(int32_t index, System::SharedPtr<ISlide> sourceSlide, System::SharedPtr<ILayoutSlide> destLayout) override

Arguments

ParameterTypeDescription
indexint32_tIndex of new slide.
sourceSlideSystem::SharedPtr<ISlide>Slide to clone.
destLayoutSystem::SharedPtr<ILayoutSlide>Layout slide for a new slide.

Return Value

Inserted slide.

SlideCollection::InsertClone(int32_t, System::SharedPtr<ISlide>, System::SharedPtr<IMasterSlide>, bool) method

Inserts a copy of a specified source slide to specified position of the collection. Appropriate layout will be selected automatically from the specified master (appropriate layout is the layout with the same Type or Name as of layout of the source slide). If there is no appropriate layout then layout of the source slide will be cloned (if allowCloneMissingLayout is true) or PptxEditException will be thrown (if allowCloneMissingLayout is false).

System::SharedPtr<ISlide> Aspose::Slides::SlideCollection::InsertClone(int32_t index, System::SharedPtr<ISlide> sourceSlide, System::SharedPtr<IMasterSlide> destMaster, bool allowCloneMissingLayout) override

Arguments

ParameterTypeDescription
indexint32_tIndex of new slide.
sourceSlideSystem::SharedPtr<ISlide>Slide to clone.
destMasterSystem::SharedPtr<IMasterSlide>Master slide for a new slide.
allowCloneMissingLayoutboolIf there is no appropriate layout in specified master then layout of the source slide will be cloned (if allowCloneMissingLayout is true) or PptxEditException will be thrown (if allowCloneMissingLayout is false).

Return Value

Inserted slide.

See Also

AddClone() AddEmptySlide()