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

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

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

Введение

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

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

В Aspose.Slides for PHP via Java (коллекция объектов Slide), доступная через объект Presentation, предоставляет методы addClone и insertClone для выполнения перечисленных типов клонирования слайдов.

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

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

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

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

  # Создать экземпляр класса Presentation, представляющего файл презентации
  $pres = new Presentation("CloneWithinSamePresentationToEnd.pptx");
  try {
    # Клонировать выбранный слайд в конец коллекции слайдов в той же презентации
    $slds = $pres->getSlides();
    $slds->addClone($pres->getSlides()->get_Item(0));
    # Записать изменённую презентацию на диск
    $pres->save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

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

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

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

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

  # Создать экземпляр класса Presentation, представляющего файл презентации
  $pres = new Presentation("CloneWithInSamePresentation.pptx");
  try {
    # Клонировать выбранный слайд в конец коллекции слайдов в той же презентации
    $slds = $pres->getSlides();
    # Клонировать выбранный слайд в указанный индекс в той же презентации
    $slds->insertClone(2, $pres->getSlides()->get_Item(1));
    # Записать изменённую презентацию на диск
    $pres->save("Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

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

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

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

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

  # Создать экземпляр класса Presentation для загрузки исходного файла презентации
  $srcPres = new Presentation("CloneAtEndOfAnother.pptx");
  try {
    # Создать экземпляр класса Presentation для целевого PPTX (куда будет клонирован слайд)
    $destPres = new Presentation();
    try {
      # Клонировать выбранный слайд из исходной презентации в конец коллекции слайдов целевой презентации
      $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, содержащий презентацию, в которую будет добавлен слайд.
Получите объект SlideCollection, ссылаясь на коллекцию Slides, доступную через объект Presentation целевой презентации.
Вызовите метод insertClone, передав слайд из исходной презентации вместе с желаемым положением в качестве параметра метода insertClone.
Сохраните изменённый файл целевой презентации.

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

  # Создать экземпляр класса Presentation для загрузки исходного файла презентации
  $srcPres = new Presentation("CloneAtEndOfAnother.pptx");
  try {
    # Создать экземпляр класса Presentation для целевого PPTX (куда будет клонирован слайд)
    $destPres = new Presentation();
    try {
      # Клонировать выбранный слайд из исходной презентации в конец коллекции слайдов целевой презентации
      $slds = $destPres->getSlides();
      $slds->insertClone(2, $srcPres->getSlides()->get_Item(0));
      # Записать целевую презентацию на диск
      $destPres->save("Aspose2_out.pptx", SaveFormat::Pptx);
    } finally {
      $destPres->dispose();
    }
  } finally {
    $srcPres->dispose();
  }

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

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

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

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

  # Создать экземпляр класса Presentation для загрузки исходного файла презентации
  $srcPres = new Presentation("CloneToAnotherPresentationWithMaster.pptx");
  try {
    # Создать экземпляр класса Presentation для целевой презентации (куда будет клонирован слайд)
    $destPres = new Presentation();
    try {
      # Получить ISlide из коллекции слайдов исходной презентации вместе с
      # мастер‑слайдом
      $SourceSlide = $srcPres->getSlides()->get_Item(0);
      $SourceMaster = $SourceSlide->getLayoutSlide()->getMasterSlide();
      # Клонировать нужный мастер‑слайд из исходной презентации в коллекцию мастеров в
      # целевой презентации
      $masters = $destPres->getMasters();
      $DestMaster = $SourceSlide->getLayoutSlide()->getMasterSlide();
      # Клонировать нужный мастер‑слайд из исходной презентации в коллекцию мастеров в
      # целевой презентации
      $iSlide = $masters->addClone($SourceMaster);
      # Клонировать нужный слайд из исходной презентации с выбранным мастером в конец
      # коллекции слайдов в целевой презентации
      $slds = $destPres->getSlides();
      $slds->addClone($SourceSlide, $iSlide, true);
      # Сохранить целевую презентацию на диск
      $destPres->save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat::Pptx);
    } finally {
      $destPres->dispose();
    }
  } finally {
    $srcPres->dispose();
  }

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

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

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

  $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));
    $section2 = $presentation->getSections()->appendEmptySection("Section 2");
    $presentation->getSlides()->addClone($presentation->getSlides()->get_Item(0), $section2);
  # Сохранить целевую презентацию на диск
    $presentation->save("CloneSlideIntoSpecifiedSection.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

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

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

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

$sourceSize = $sourcePresentation->getSlideSize()->getSize();

$targetPresentation->getSlideSize()->setSize(
    $sourceSize->getWidth(), $sourceSize->getHeight(), SlideSizeScaleType::DoNotScale);

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

FAQ

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

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

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

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