Clonar Slides de Apresentação em PHP

Sobre o que é esta página

Duplique rapidamente slides de PowerPoint com Aspose.Slides for PHP. Siga nossos claros exemplos de código para automatizar a criação de PPT em segundos e eliminar o trabalho manual.

Introdução

Clonagem é o processo de fazer uma cópia exata ou réplica de algo. Aspose.Slides for PHP via Java também possibilita fazer uma cópia ou clone de qualquer slide e então inserir esse slide clonado na apresentação atual ou em qualquer outra apresentação aberta. O processo de clonagem de slide cria um novo slide que pode ser modificado pelos desenvolvedores sem alterar o slide original. Existem várias maneiras possíveis de clonar um slide:

Clonar no final dentro de uma apresentação.
Clonar em outra posição dentro da apresentação.
Clonar no final em outra apresentação.
Clonar em outra posição em outra apresentação.
Clonar em uma posição específica em outra apresentação.

No Aspose.Slides for PHP via Java, (uma coleção de Slide objetos) exposta pelo objeto Presentation fornece os métodos addClone e insertClone para executar os tipos de clonagem de slide acima.

Clonar um slide no final de uma apresentação

Se você deseja clonar um slide e então usá‑lo dentro do mesmo arquivo de apresentação ao final dos slides existentes, use o método addClone de acordo com os passos listados abaixo:

Crie uma instância da classe Presentation.
Obtenha o objeto SlideCollection referenciando a coleção de slides exposta pelo objeto Presentation.
Chame o método addClone exposto pelo objeto SlideCollection e passe o slide a ser clonado como parâmetro ao método addClone.
Grave o arquivo de apresentação modificado.

No exemplo abaixo, clonamos um slide (localizado na primeira posição – índice zero – da apresentação) para o final da apresentação.

  # Instanciar a classe Presentation que representa um arquivo de apresentação
  $pres = new Presentation("CloneWithinSamePresentationToEnd.pptx");
  try {
    # Clonar o slide desejado para o final da coleção de slides na mesma apresentação
    $slds = $pres->getSlides();
    $slds->addClone($pres->getSlides()->get_Item(0));
    # Gravar a apresentação modificada no disco
    $pres->save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Clonar um slide para outra posição dentro de uma apresentação

Se você deseja clonar um slide e então usá‑lo dentro do mesmo arquivo de apresentação, mas em outra posição, use o método insertClone:

Crie uma instância da classe Presentation.
Obtenha o objeto SlideCollection referenciando a coleção Slides exposta pelo objeto Presentation.
Chame o método insertClone exposto pelo objeto SlideCollection e passe o slide a ser clonado junto com o índice da nova posição como parâmetro ao método insertClone.
Grave a apresentação modificada como um arquivo PPTX.

No exemplo abaixo, clonamos um slide (localizado no índice zero – posição 1 – da apresentação) para o índice 1 – posição 2 – da apresentação.

  # Instanciar a classe Presentation que representa um arquivo de apresentação
  $pres = new Presentation("CloneWithInSamePresentation.pptx");
  try {
    # Clonar o slide desejado para o final da coleção de slides na mesma apresentação
    $slds = $pres->getSlides();
    # Clonar o slide desejado para o índice especificado na mesma apresentação
    $slds->insertClone(2, $pres->getSlides()->get_Item(1));
    # Gravar a apresentação modificada no disco
    $pres->save("Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Clonar um slide no final de outra apresentação

Se precisar clonar um slide de uma apresentação e usá‑lo em outra apresentação, no final dos slides existentes:

Crie uma instância da classe Presentation que contém a apresentação de origem do slide.
Crie uma instância da classe Presentation que contém a apresentação de destino onde o slide será adicionado.
Obtenha o objeto SlideCollection referenciando a coleção Slides exposta pelo objeto Presentation da apresentação de destino.
Chame o método addClone exposto pelo objeto SlideCollection e passe o slide da apresentação de origem como parâmetro ao método addClone.
Grave o arquivo da apresentação de destino modificado.

No exemplo abaixo, clonamos um slide (do primeiro índice da apresentação de origem) para o final da apresentação de destino.

  # Instanciar a classe Presentation para carregar o arquivo de apresentação de origem
  $srcPres = new Presentation("CloneAtEndOfAnother.pptx");
  try {
    # Instanciar a classe Presentation para o PPTX de destino (onde o slide será clonado)
    $destPres = new Presentation();
    try {
      # Clonar o slide desejado da apresentação de origem para o final da coleção de slides na apresentação de destino
      $slds = $destPres->getSlides();
      $slds->addClone($srcPres->getSlides()->get_Item(0));
      # Gravar a apresentação de destino no disco
      $destPres->save("Aspose2_out.pptx", SaveFormat::Pptx);
    } finally {
      $destPres->dispose();
    }
  } finally {
    $srcPres->dispose();
  }

Clonar um slide para outra posição em outra apresentação

Se precisar clonar um slide de uma apresentação e usá‑lo em outra apresentação, em uma posição específica:

Crie uma instância da classe Presentation que contém a apresentação de origem do slide.
Crie uma instância da classe Presentation que contém a apresentação de destino onde o slide será adicionado.
Obtenha a classe SlideCollection referenciando a coleção Slides exposta pelo objeto Presentation da apresentação de destino.
Chame o método insertClone exposto pelo objeto SlideCollection e passe o slide da apresentação de origem juntamente com a posição desejada como parâmetro ao método insertClone.
Grave o arquivo da apresentação de destino modificado.

No exemplo abaixo, clonamos um slide (do índice zero da apresentação de origem) para o índice 1 (posição 2) da apresentação de destino.

  # Instanciar a classe Presentation para carregar o arquivo de apresentação de origem
  $srcPres = new Presentation("CloneAtEndOfAnother.pptx");
  try {
    # Instanciar a classe Presentation para o PPTX de destino (onde o slide será clonado)
    $destPres = new Presentation();
    try {
      # Clonar o slide desejado da apresentação de origem para o final da coleção de slides na apresentação de destino
      $slds = $destPres->getSlides();
      $slds->insertClone(2, $srcPres->getSlides()->get_Item(0));
      # Gravar a apresentação de destino no disco
      $destPres->save("Aspose2_out.pptx", SaveFormat::Pptx);
    } finally {
      $destPres->dispose();
    }
  } finally {
    $srcPres->dispose();
  }

Clonar um slide em uma posição específica em outra apresentação

Se precisar clonar um slide com um slide mestre de uma apresentação e usá‑lo em outra apresentação, primeiro clone o slide mestre desejado da apresentação de origem para a de destino. Em seguida, use esse slide mestre ao clonar o slide com mestre. O método addClone(Slide, MasterSlide, boolean) espera um slide mestre da apresentação de destino, e não da apresentação de origem. Para clonar o slide com mestre, siga os passos abaixo:

Crie uma instância da classe Presentation que contém a apresentação de origem do slide.
Crie uma instância da classe Presentation que contém a apresentação de destino onde o slide será clonado.
Acesse o slide a ser clonado junto com seu slide mestre.
Instancie a classe MasterSlideCollection referenciando a coleção Masters exposta pelo objeto Presentation da apresentação de destino.
Chame o método addClone exposto pelo objeto MasterSlideCollection e passe o mestre da apresentação de origem a ser clonado como parâmetro ao método addClone.
Instancie a classe SlideCollection definindo a referência para a coleção Slides exposta pelo objeto Presentation da apresentação de destino.
Chame o método addClone exposto pelo objeto SlideCollection e passe o slide da apresentação de origem a ser clonado e o slide mestre como parâmetros ao método addClone.
Grave o arquivo da apresentação de destino modificado.

No exemplo abaixo, clonamos um slide com mestre (localizado no índice zero da apresentação de origem) para o final da apresentação de destino usando o mestre do slide de origem.

  # Instanciar a classe Presentation para carregar o arquivo de apresentação de origem
  $srcPres = new Presentation("CloneToAnotherPresentationWithMaster.pptx");
  try {
    # Instanciar a classe Presentation para a apresentação de destino (onde o slide será clonado)
    $destPres = new Presentation();
    try {
      # Instanciar ISlide a partir da coleção de slides da apresentação de origem juntamente com
      # Slide mestre
      $SourceSlide = $srcPres->getSlides()->get_Item(0);
      $SourceMaster = $SourceSlide->getLayoutSlide()->getMasterSlide();
      # Clonar o slide mestre desejado da apresentação de origem para a coleção de mestres na
      # apresentação de destino
      $masters = $destPres->getMasters();
      $DestMaster = $SourceSlide->getLayoutSlide()->getMasterSlide();
      # Clonar o slide mestre desejado da apresentação de origem para a coleção de mestres na
      # apresentação de destino
      $iSlide = $masters->addClone($SourceMaster);
      # Clonar o slide desejado da apresentação de origem com o mestre desejado para o final da
      # coleção de slides na apresentação de destino
      $slds = $destPres->getSlides();
      $slds->addClone($SourceSlide, $iSlide, true);
      # Salvar a apresentação de destino no disco
      $destPres->save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat::Pptx);
    } finally {
      $destPres->dispose();
    }
  } finally {
    $srcPres->dispose();
  }

Clonar um slide no final de uma seção especificada

Se você deseja clonar um slide e então usá‑lo dentro do mesmo arquivo de apresentação, mas em outra seção, use o método addClone exposto pela classe SlideCollection. Aspose.Slides for PHP via Java possibilita clonar um slide da primeira seção e inseri‑lo na segunda seção da mesma apresentação.

O trecho de código a seguir mostra como clonar um slide e inserir o slide clonado em uma seção especificada.

  $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);
    # Salvar a apresentação de destino no disco
    $presentation->save("CloneSlideIntoSpecifiedSection.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

Garantir correspondência de tamanho de slide

Ao clonar slides para outra apresentação, certifique‑se de que a apresentação de destino possua o mesmo tamanho de slide da origem. Se os tamanhos forem diferentes, o Aspose.Slides não redimensiona automaticamente as formas clonadas – suas coordenadas e dimensões originais são preservadas, o que pode fazer com que o conteúdo fique desalinhado ou ultrapasse os limites do slide.

Você pode definir o tamanho do slide da apresentação de destino para corresponder ao da origem antes de clonar o mestre e o slide:

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

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

Faça isso antes de clonar o mestre e o slide.

FAQ

As notas do apresentador e os comentários dos revisores são clonados?

Sim. A página de notas e os comentários de revisão são incluídos no clone. Se não quiser mantê‑los, removê‑los após a inserção.

Como os gráficos e suas fontes de dados são tratados?

O objeto do gráfico, sua formatação e os dados incorporados são copiados. Se o gráfico estiver vinculado a uma fonte externa (por exemplo, uma pasta de trabalho incorporada via OLE), esse vínculo é preservado como um OLE object. Após mover entre arquivos, verifique a disponibilidade dos dados e o comportamento de atualização.

Posso controlar a posição de inserção e as seções do clone?

Sim. Você pode inserir o clone em um índice de slide específico e colocá‑lo em uma section escolhida. Se a seção de destino não existir, crie‑a primeiro e então mova o slide para ela.

Remover Slides de Apresentações em PHP Comparar Slides de Apresentação em PHP