Клонирование слайдов презентации в Java

О чём эта страница

Быстро дублируйте слайды PowerPoint с помощью Aspose.Slides for Java. Следуйте нашим понятным примерам кода, чтобы автоматизировать создание PPT за секунды и избавиться от ручной работы.

Введение

Клонирование — это процесс создания точной копии или реплики чего‑либо. Aspose.Slides for Java также позволяет создать копию или клон любого слайда и затем вставить этот клон в текущую или любую другую открытую презентацию. Процесс клонирования слайда создаёт новый слайд, который разработчики могут изменять, не затрагивая исходный слайд. Существует несколько способов клонирования слайда:

Клонировать в конец внутри презентации.
Клонировать в другое положение внутри презентации.
Клонировать в конец в другой презентации.
Клонировать в другое положение в другой презентации.
Клонировать вместе с его мастер‑слайдом в другую презентацию.

In Aspose.Slides for Java (коллекция объектов ISlide ), доступная через объект Presentation , предоставляет методы addClone и insertClone , позволяющие выполнять перечисленные типы клонирования слайдов.

Клонирование слайда в конец презентации

Если вы хотите клонировать слайд и затем использовать его в том же файле презентации в конце существующих слайдов, используйте метод addClone согласно шагам, перечисленным ниже:

Создайте экземпляр класса Presentation.
Создайте объект ISlideCollection , ссылаясь на коллекцию Slides, предоставляемую объектом Presentation.
Вызовите метод addClone , доступный у объекта ISlideCollection и передайте слайд, который нужно клонировать, в качестве параметра.
Сохраните изменённый файл презентации.

В приведённом ниже примере мы клонировали слайд (находящийся в первой позиции – индекс 0 – презентации) в конец презентации.

import com.aspose.slides.*;

// Создайте экземпляр класса Presentation, представляющего файл презентации
Presentation pres = new Presentation("CloneWithinSamePresentationToEnd.pptx");
try {
    // Клонируйте выбранный слайд в конец коллекции слайдов в той же презентации
    ISlideCollection slds = pres.getSlides();

    slds.addClone(pres.getSlides().get_Item(0));

    // Сохраните изменённую презентацию на диск
    pres.save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Клонирование слайда в другое положение внутри презентации

Если вы хотите клонировать слайд и затем использовать его в том же файле презентации, но в другой позиции, используйте метод insertClone:

Создайте экземпляр класса Presentation.
Создайте объект, ссылаясь на коллекцию Slides , предоставляемую объектом Presentation.
Вызовите метод insertClone , доступный у объекта ISlideCollection и передайте слайд, который нужно клонировать, вместе с индексом новой позиции в качестве параметра.
Сохраните изменённую презентацию в формате PPTX.

В приведённом ниже примере мы клонировали слайд (находящийся в индексе 1 – позиция 2 – презентации) в индекс 2 – позицию 3 – презентации.

import com.aspose.slides.*;

// Создайте экземпляр класса Presentation, представляющего файл презентации
Presentation pres = new Presentation("CloneWithInSamePresentation.pptx");
try {
    // Получите коллекцию слайдов в презентации
    ISlideCollection slds = pres.getSlides();

    // Клонируйте выбранный слайд в указанный индекс в той же презентации
    slds.insertClone(2, pres.getSlides().get_Item(1));

    // Сохраните изменённую презентацию на диск
    pres.save("Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Клонирование слайда в конец другой презентации

Если необходимо клонировать слайд из одной презентации и использовать его в файле другой презентации, в конце существующих слайдов:

Создайте экземпляр класса Presentation, содержащий презентацию, из которой будет клонироваться слайд.
Создайте экземпляр класса Presentation, содержащий целевую презентацию, в которую будет добавлен слайд.
Создайте объект ISlideCollection , ссылаясь на коллекцию Slides , предоставляемую объектом Presentation целевой презентации.
Вызовите метод addClone , доступный у объекта ISlideCollection и передайте в него слайд из исходной презентации.
Сохраните изменённый файл целевой презентации.

В приведённом ниже примере мы клонировали слайд (из первого индекса исходной презентации) в конец целевой презентации.

import com.aspose.slides.*;

// Создайте экземпляр класса Presentation для загрузки исходного файла презентации
Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx");
try {
    // Создайте экземпляр класса Presentation для целевого PPTX (куда будет клонирован слайд)
    Presentation destPres = new Presentation();
    try {
        // Клонируйте выбранный слайд из исходной презентации в конец коллекции слайдов целевой презентации
        ISlideCollection slds = destPres.getSlides();

        slds.addClone(srcPres.getSlides().get_Item(0));

        // Сохраните целевую презентацию на диск
        destPres.save("Aspose2_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

Клонирование слайда в другое положение в другой презентации

Если необходимо клонировать слайд из одной презентации и использовать его в файле другой презентации, в определённой позиции:

Создайте экземпляр класса Presentation, содержащий презентацию, из которой будет клонироваться слайд.
Создайте экземпляр класса Presentation, содержащий презентацию, в которую будет добавлен слайд.
Создайте объект ISlideCollection , ссылаясь на коллекцию Slides, предоставляемую объектом Presentation целевой презентации.
Вызовите метод insertClone , доступный у объекта ISlideCollection и передайте слайд из исходной презентации вместе с требуемой позицией в качестве параметра.
Сохраните изменённый файл целевой презентации.

В приведённом ниже примере мы клонировали слайд (из нулевого индекса исходной презентации) в индекс 1 (позиция 2) целевой презентации.

import com.aspose.slides.*;

// Создайте экземпляр класса Presentation для загрузки исходного файла презентации
Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx");
try {
    // Создайте экземпляр класса Presentation для целевого PPTX (куда будет клонирован слайд)
    Presentation destPres = new Presentation();
    try {
        // Клонируйте выбранный слайд из исходной презентации в указанный индекс целевой презентации
        ISlideCollection slds = destPres.getSlides();

        slds.insertClone(1, srcPres.getSlides().get_Item(0));

        // Сохраните целевую презентацию на диск
        destPres.save("Aspose2_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

Клонирование слайда с его мастер‑слайдом в другую презентацию

Если необходимо клонировать слайд вместе с мастер‑слайдом из одной презентации и использовать его в другой презентации, сначала нужно склонировать нужный мастер‑слайд из исходной презентации в целевую. Затем следует использовать этот мастер‑слайд при клонировании слайда с мастер‑слайдом. Метод [addClone(ISlide, IMasterSlide, boolean)] ожидает мастер‑слайд из целевой презентации, а не из исходной. Чтобы клонировать слайд с мастер‑слайдом, выполните следующие шаги:

Создайте экземпляр класса Presentation, содержащий исходную презентацию, из которой будет клонироваться слайд.
Создайте экземпляр класса Presentation, содержащий целевую презентацию, в которую будет клонироваться слайд.
Получите доступ к слайду, который будет клонироваться, вместе с его мастер‑слайдом.
Создайте объект IMasterSlideCollection , ссылаясь на коллекцию Masters, предоставляемую объектом Presentation целевой презентации.
Вызовите метод addClone , доступный у объекта IMasterSlideCollection и передайте в него мастер‑слайд из исходного PPTX для клонирования.
Создайте объект ISlideCollection , установив ссылку на коллекцию Slides, предоставляемую объектом Presentation целевой презентации.
Вызовите метод addClone , доступный у объекта ISlideCollection и передайте в него слайд из исходной презентации, который нужно клонировать, и мастер‑слайд.
Сохраните изменённый файл целевой презентации.

В приведённом ниже примере мы клонировали слайд с мастер‑слайдом (находящийся в нулевом индексе исходной презентации) в конец целевой презентации, используя мастер‑слайд из исходного слайда.

import com.aspose.slides.*;

// Создайте экземпляр класса Presentation для загрузки исходного файла презентации
Presentation srcPres = new Presentation("CloneToAnotherPresentationWithMaster.pptx");
try {
    // Создайте экземпляр класса Presentation для целевой презентации (куда будет клонирован слайд)
    Presentation destPres = new Presentation();
    try {
        // Получите ISlide из коллекции слайдов исходной презентации вместе с
        // мастер-слайдом
        ISlide SourceSlide = srcPres.getSlides().get_Item(0);
        IMasterSlide SourceMaster = SourceSlide.getLayoutSlide().getMasterSlide();

        // Клонируйте выбранный мастер-слайд из исходной презентации в коллекцию мастеров в
        // целевой презентации
        IMasterSlideCollection masters = destPres.getMasters();
        IMasterSlide DestMaster = masters.addClone(SourceMaster);

        // Клонируйте выбранный слайд из исходной презентации с нужным мастером в конец
        // коллекции слайдов целевой презентации
        ISlideCollection slds = destPres.getSlides();
        slds.addClone(SourceSlide, DestMaster, true);

        // Сохраните целевую презентацию на диск
        destPres.save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

Клонирование слайда в конец указанного раздела

Если вы хотите клонировать слайд и затем использовать его в том же файле презентации, но в другом разделе, используйте метод addClone , доступный у интерфейса ISlideCollection. Aspose.Slides for Java позволяет клонировать слайд из первого раздела и затем вставить его во второй раздел той же презентации.

В следующем фрагменте кода показано, как клонировать слайд и вставить клонированный слайд в указанный раздел.

import com.aspose.slides.*;

IPresentation presentation = new Presentation();
try {
    presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 200, 50, 300, 100);
    presentation.getSections().addSection("Section 1", presentation.getSlides().get_Item(0));

    ISection section2 = presentation.getSections().appendEmptySection("Section 2");
    presentation.getSlides().addClone(presentation.getSlides().get_Item(0), section2);

    // Сохраните целевую презентацию на диск
    presentation.save("CloneSlideIntoSpecifiedSection.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Обеспечение совпадения размера слайдов

При клонировании слайдов в другую презентацию убедитесь, что размер слайдов целевой презентации совпадает с размером слайдов исходной. Если размеры отличаются, Aspose.Slides не масштабирует автоматически клонированные объекты — их исходные координаты и размеры сохраняются, что может привести к смещению содержимого или выходу за границы слайда.

Вы можете установить размер слайдов целевой презентации, соответствующий размеру исходной, перед клонированием мастер‑слайда и слайда:

Dimension2D sourceSize = sourcePresentation.getSlideSize().getSize();

targetPresentation.getSlideSize().setSize(
        sourceSize.getWidth(), sourceSize.getHeight(), SlideSizeScaleType.DoNotScale);

Сделайте это перед клонированием мастер‑слайда и слайда.

FAQ

Клонируются ли заметки выступающего и комментарии рецензента?

Да. Страница заметок и комментарии рецензента включаются в клон. Если вы их не хотите, удалите их после вставки.

Как обрабатываются диаграммы и их источники данных?

Объект диаграммы, его форматирование и встроенные данные копируются. Если диаграмма была связана с внешним источником (например, с OLE‑встроенной книгой), эта связь сохраняется как OLE‑объект. После перемещения между файлами проверьте доступность данных и поведение обновления.

Могу ли я контролировать позицию вставки и разделы для клона?

Да. Вы можете вставить клон в определённый индекс слайда и поместить его в выбранный раздел. Если целевой раздел не существует, сначала создайте его, а затем переместите слайд в него.

Удалить слайды из презентаций в Java Сравнение слайдов презентации в Java