Klonowanie slajdów prezentacji w PHP

Wprowadzenie

Klonowanie to proces tworzenia dokładnej kopii lub repliki czegoś. Aspose.Slides for PHP via Java umożliwia również wykonanie kopii lub klonu dowolnego slajdu i wstawienie tego sklonowanego slajdu do bieżącej lub dowolnej innej otwartej prezentacji. Proces klonowania slajdu tworzy nowy slajd, który może być modyfikowany przez programistów bez zmiany oryginalnego slajdu. Istnieje kilka możliwych sposobów klonowania slajdu:

  • Klonowanie na końcu w obrębie prezentacji.
  • Klonowanie w innym miejscu w obrębie prezentacji.
  • Klonowanie na końcu w innej prezentacji.
  • Klonowanie w innym miejscu w innej prezentacji.
  • Klonowanie w określonym miejscu w innej prezentacji.

In Aspose.Slides for PHP via Java, (kolekcja obiektów Slide ) udostępniona przez obiekt Presentation zapewnia metody addClone oraz insertClone, które umożliwiają wykonanie powyższych rodzajów klonowania slajdów

Klonowanie slajdu na końcu prezentacji

Jeśli chcesz sklonować slajd i użyć go w tym samym pliku prezentacji na końcu istniejących slajdów, użyj metody addClone zgodnie z poniższymi krokami:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj obiekt SlideCollection odwołując się do kolekcji slajdów udostępnionej przez obiekt Presentation.
  3. Wywołaj metodę addClone udostępnioną przez obiekt SlideCollection, przekazując slajd do sklonowania jako parametr do metody addClone.
  4. Zapisz zmodyfikowany plik prezentacji.

W poniższym przykładzie sklonowaliśmy slajd (znajdujący się na pierwszej pozycji – indeks zero – prezentacji) na koniec prezentacji.

  # Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji
  $pres = new Presentation("CloneWithinSamePresentationToEnd.pptx");
  try {
    # Sklonuj wybrany slajd na koniec kolekcji slajdów w tej samej prezentacji
    $slds = $pres->getSlides();
    $slds->addClone($pres->getSlides()->get_Item(0));
    # Zapisz zmodyfikowaną prezentację na dysku
    $pres->save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Klonowanie slajdu w innym miejscu w obrębie prezentacji

Jeśli chcesz sklonować slajd i użyć go w tym samym pliku prezentacji, ale w innym miejscu, użyj metody insertClone:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj obiekt SlideCollection odwołując się do kolekcji Slides udostępnionej przez obiekt Presentation.
  3. Wywołaj metodę insertClone udostępnioną przez obiekt SlideCollection, przekazując slajd do sklonowania wraz z indeksem nowej pozycji jako parametr do metody insertClone.
  4. Zapisz zmodyfikowaną prezentację jako plik PPTX.

W poniższym przykładzie sklonowaliśmy slajd (znajdujący się na indeksie zero – pozycja 1 – prezentacji) na indeks 1 – pozycja 2 – prezentacji.

  # Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji
  $pres = new Presentation("CloneWithInSamePresentation.pptx");
  try {
    # Sklonuj wybrany slajd na koniec kolekcji slajdów w tej samej prezentacji
    $slds = $pres->getSlides();
    # Sklonuj wybrany slajd do określonego indeksu w tej samej prezentacji
    $slds->insertClone(2, $pres->getSlides()->get_Item(1));
    # Zapisz zmodyfikowaną prezentację na dysku
    $pres->save("Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Klonowanie slajdu na końcu innej prezentacji

Jeśli potrzebujesz sklonować slajd z jednej prezentacji i użyć go w innej prezentacji, na końcu istniejących slajdów:

  1. Utwórz instancję klasy Presentation, zawierającą prezentację, z której slajd zostanie sklonowany.
  2. Utwórz instancję klasy Presentation, zawierającą docelową prezentację, do której slajd zostanie dodany.
  3. Uzyskaj obiekt SlideCollection odwołując się do kolekcji Slides udostępnionej przez obiekt Presentation docelowej prezentacji.
  4. Wywołaj metodę addClone udostępnioną przez obiekt SlideCollection, przekazując slajd z prezentacji źródłowej jako parametr do metody addClone.
  5. Zapisz zmodyfikowany plik docelowej prezentacji.

W poniższym przykładzie sklonowaliśmy slajd (z pierwszego indeksu prezentacji źródłowej) na koniec docelowej prezentacji.

  # Utwórz instancję klasy Presentation, aby wczytać plik źródłowej prezentacji
  $srcPres = new Presentation("CloneAtEndOfAnother.pptx");
  try {
    # Utwórz instancję klasy Presentation dla docelowego PPTX (gdzie slajd ma być sklonowany)
    $destPres = new Presentation();
    try {
      # Sklonuj wybrany slajd ze źródłowej prezentacji na koniec kolekcji slajdów w prezentacji docelowej
      $slds = $destPres->getSlides();
      $slds->addClone($srcPres->getSlides()->get_Item(0));
      # Zapisz docelową prezentację na dysku
      $destPres->save("Aspose2_out.pptx", SaveFormat::Pptx);
    } finally {
      $destPres->dispose();
    }
  } finally {
    $srcPres->dispose();
  }

Klonowanie slajdu w innym miejscu w innej prezentacji

Jeśli potrzebujesz sklonować slajd z jednej prezentacji i użyć go w innej prezentacji, w określonym miejscu:

  1. Utwórz instancję klasy Presentation, zawierającą prezentację źródłową, z której slajd zostanie sklonowany.
  2. Utwórz instancję klasy Presentation, zawierającą prezentację, do której slajd zostanie dodany.
  3. Uzyskaj klasę SlideCollection odwołując się do kolekcji Slides udostępnionej przez obiekt Presentation docelowej prezentacji.
  4. Wywołaj metodę insertClone udostępnioną przez obiekt SlideCollection, przekazując slajd z prezentacji źródłowej wraz z żądaną pozycją jako parametr do metody insertClone.
  5. Zapisz zmodyfikowany plik docelowej prezentacji.

W poniższym przykładzie sklonowaliśmy slajd (z indeksu zero prezentacji źródłowej) na indeks 1 (pozycja 2) docelowej prezentacji.

  # Utwórz instancję klasy Presentation, aby wczytać plik źródłowej prezentacji
  $srcPres = new Presentation("CloneAtEndOfAnother.pptx");
  try {
    # Utwórz instancję klasy Presentation dla docelowego PPTX (gdzie slajd ma być sklonowany)
    $destPres = new Presentation();
    try {
      # Sklonuj wybrany slajd ze źródłowej prezentacji na koniec kolekcji slajdów w prezentacji docelowej
      $slds = $destPres->getSlides();
      $slds->insertClone(2, $srcPres->getSlides()->get_Item(0));
      # Zapisz docelową prezentację na dysku
      $destPres->save("Aspose2_out.pptx", SaveFormat::Pptx);
    } finally {
      $destPres->dispose();
    }
  } finally {
    $srcPres->dispose();
  }

Klonowanie slajdu w określonym miejscu w innej prezentacji

Jeśli potrzebujesz sklonować slajd wraz z master slajdem z jednej prezentacji i użyć go w innej prezentacji, najpierw musisz sklonować odpowiedni master slajd z prezentacji źródłowej do prezentacji docelowej. Następnie należy użyć tego master slajdu do klonowania slajdu z masterem. Metoda addClone(Slide, MasterSlide, boolean) oczekuje master slajdu z prezentacji docelowej, a nie ze źródłowej. Aby sklonować slajd z masterem, wykonaj poniższe kroki:

  1. Utwórz instancję klasy Presentation zawierającą prezentację źródłową, z której slajd zostanie sklonowany.
  2. Utwórz instancję klasy Presentation zawierającą prezentację docelową, do której slajd zostanie sklonowany.
  3. Uzyskaj dostęp do slajdu, który ma być sklonowany, wraz z master slajdem.
  4. Utwórz instancję klasy MasterSlideCollection odwołując się do kolekcji Masters udostępnionej przez obiekt Presentation docelowej prezentacji.
  5. Wywołaj metodę addClone udostępnioną przez obiekt MasterSlideCollection, przekazując master ze źródłowego PPTX do sklonowania jako parametr do metody addClone.
  6. Utwórz instancję klasy SlideCollection ustawiając odwołanie do kolekcji Slides udostępnionej przez obiekt Presentation docelowej prezentacji.
  7. Wywołaj metodę addClone udostępnioną przez obiekt SlideCollection, przekazując slajd z prezentacji źródłowej do sklonowania oraz master slajd jako parametr do metody addClone.
  8. Zapisz zmodyfikowany plik docelowej prezentacji.

W poniższym przykładzie sklonowaliśmy slajd z masterem (znajdujący się na indeksie zero prezentacji źródłowej) na koniec docelowej prezentacji, używając mastera ze slajdu źródłowego.

  # Utwórz instancję klasy Presentation, aby wczytać plik źródłowej prezentacji
  $srcPres = new Presentation("CloneToAnotherPresentationWithMaster.pptx");
  try {
    # Utwórz instancję klasy Presentation dla docelowej prezentacji (gdzie slajd ma być sklonowany)
    $destPres = new Presentation();
    try {
      # Utwórz ISlide z kolekcji slajdów w prezentacji źródłowej wraz z
      # Slajdem master
      $SourceSlide = $srcPres->getSlides()->get_Item(0);
      $SourceMaster = $SourceSlide->getLayoutSlide()->getMasterSlide();
      # Sklonuj wybrany slajd master z prezentacji źródłowej do kolekcji masterów w
      # prezentacji docelowej
      $masters = $destPres->getMasters();
      $DestMaster = $SourceSlide->getLayoutSlide()->getMasterSlide();
      # Sklonuj wybrany slajd master z prezentacji źródłowej do kolekcji masterów w
      # prezentacji docelowej
      $iSlide = $masters->addClone($SourceMaster);
      # Sklonuj wybrany slajd z prezentacji źródłowej z wybranym masterem na koniec
      # kolekcji slajdów w prezentacji docelowej
      $slds = $destPres->getSlides();
      $slds->addClone($SourceSlide, $iSlide, true);
      # Zapisz docelową prezentację na dysku
      $destPres->save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat::Pptx);
    } finally {
      $destPres->dispose();
    }
  } finally {
    $srcPres->dispose();
  }

Klonowanie slajdu na końcu określonej sekcji

Jeśli chcesz sklonować slajd i użyć go w tym samym pliku prezentacji, ale w innej sekcji, użyj metody addClone udostępnionej przez klasę SlideCollection. Aspose.Slides for PHP via Java umożliwia sklonowanie slajdu z pierwszej sekcji i wstawienie go do drugiej sekcji tej samej prezentacji.

Poniższy fragment kodu pokazuje, jak sklonować slajd i wstawić sklonowany slajd do określonej sekcji.

  $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);
    # Zapisz docelową prezentację na dysku
    $presentation->save($dataDir . "CloneSlideIntoSpecifiedSection.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

FAQ

Czy notatki prelegenta i komentarze recenzenta są klonowane?

Tak. Strona z notatkami i komentarze recenzenta są włączone do klonu. Jeśli ich nie chcesz, usuń je po wstawieniu.

Jak obsługiwane są wykresy i ich źródła danych?

Obiekt wykresu, formatowanie i osadzone dane są kopiowane. Jeśli wykres był powiązany z zewnętrznym źródłem (np. skoroszytem osadzonym jako OLE), to połączenie jest zachowane jako obiekt OLE. Po przeniesieniu między plikami sprawdź dostępność danych i zachowanie odświeżania.

Czy mogę kontrolować pozycję wstawiania i sekcje klonu?

Tak. Możesz wstawić klon na określonym indeksie slajdu i umieścić go w wybranej sekcji. Jeśli docelowa sekcja nie istnieje, najpierw ją utwórz, a następnie przenieś do niej slajd.