Gerenciar Zoom de Apresentação em PHP
Introdução
Os zooms do PowerPoint permitem navegar entre slides e seções específicos durante a apresentação. Com o Aspose.Slides para PHP via Java, você pode criar zooms de slide, seção e resumo e personalizar suas visualizações, bordas e transições.

- Para resumir toda a apresentação em um único slide, use um Zoom de Resumo.
- Para mostrar apenas slides selecionados, use um Zoom de Slide.
- Para mostrar apenas uma única seção, use um Zoom de Seção.
Zoom de Slide
Um zoom de slide pode tornar sua apresentação mais dinâmica, permitindo que você navegue livremente entre slides em qualquer ordem que desejar sem interromper o fluxo da apresentação. Os zooms de slide são ótimos para apresentações curtas sem muitas seções, mas ainda podem ser usados em diferentes cenários de apresentação.
Os zooms de slide permitem que você explore informações relacionadas a partir de um único slide de visão geral.

Para objetos de zoom de slide, o Aspose.Slides fornece a enumeração ZoomImageType, a classe ZoomFrame e métodos na classe ShapeCollection.
Criar Quadros de Zoom
Use ShapeCollection::addZoomFrame para colocar links para slides individuais em um slide de visão geral. Este exemplo cria dois slides de destino com fundos e rótulos distintos, então adiciona uma visualização de cada um ao primeiro slide e salva a apresentação como PPTX. As posições e dimensões dos quadros são especificadas em pontos.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$secondSlide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$thirdSlide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$secondSlide->getBackground()->setType(BackgroundType::OwnBackground);
$secondSlide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$secondSlide->getBackground()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->CYAN);
$textBox = $secondSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 500, 200);
$textBox->getTextFrame()->setText("Second Slide");
$thirdSlide->getBackground()->setType(BackgroundType::OwnBackground);
$thirdSlide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 189, 183, 107);
$thirdSlide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$textBox = $thirdSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 500, 200);
$textBox->getTextFrame()->setText("Third Slide");
$overviewSlide->getShapes()->addZoomFrame(20, 20, 250, 200, $secondSlide);
$overviewSlide->getShapes()->addZoomFrame(200, 250, 250, 200, $thirdSlide);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Criar Quadros de Zoom com Imagens Personalizadas
Passe uma imagem personalizada para ShapeCollection::addZoomFrame para substituir a visualização padrão do slide de destino. Este exemplo requer uma imagem local, carrega‑a com Images::fromFile e a adiciona à apresentação usando ImageCollection::addImage. O quadro resultante exibe essa imagem enquanto ainda vincula ao segundo slide.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Images;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->CYAN);
$textBox = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 500, 200);
$textBox->getTextFrame()->setText("Second Slide");
$image = Images::fromFile("image.png");
try {
$previewImage = $presentation->getImages()->addImage($image);
} finally {
$image->dispose();
}
$overviewSlide->getShapes()->addZoomFrame(20, 20, 300, 200, $slide, $previewImage);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Formatar Quadros de Zoom
Este exemplo customiza dois quadros de zoom de slide. Ele atribui uma imagem local ao primeiro quadro através de ZoomObject::setZoomImage e dá ao segundo quadro uma borda rosa tracejada de cinco pontos através de Shape::getLineFormat. Passar false para ZoomObject::setShowBackground oculta o plano de fundo do segundo quadro. Uma imagem local é necessária para a visualização personalizada; ambos os quadros mantêm seus destinos de slide no PPTX salvo.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Images;
use aspose\slides\LineDashStyle;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$secondSlide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$thirdSlide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$secondSlide->getBackground()->setType(BackgroundType::OwnBackground);
$secondSlide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$secondSlide->getBackground()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->CYAN);
$textBox = $secondSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 500, 200);
$textBox->getTextFrame()->setText("Second Slide");
$thirdSlide->getBackground()->setType(BackgroundType::OwnBackground);
$thirdSlide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 189, 183, 107);
$thirdSlide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$textBox = $thirdSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 500, 200);
$textBox->getTextFrame()->setText("Third Slide");
$firstZoomFrame = $overviewSlide->getShapes()->addZoomFrame(20, 20, 250, 200, $secondSlide);
$secondZoomFrame = $overviewSlide->getShapes()->addZoomFrame(200, 250, 250, 200, $thirdSlide);
$image = Images::fromFile("image.png");
try {
$previewImage = $presentation->getImages()->addImage($image);
} finally {
$image->dispose();
}
$firstZoomFrame->setZoomImage($previewImage);
$secondZoomFrame->getLineFormat()->setWidth(5);
$secondZoomFrame->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 255, 105, 180);
$secondZoomFrame->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor($color);
$secondZoomFrame->getLineFormat()->setDashStyle(LineDashStyle::DashDot);
$secondZoomFrame->setShowBackground(false);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Zoom de Seção
Um zoom de seção vincula a uma seção da sua apresentação. Use‑o para revisitar um tópico ou mostrar como diferentes partes da apresentação se conectam.

Para objetos de zoom de seção, o Aspose.Slides fornece a classe SectionZoomFrame e métodos na classe ShapeCollection.
Criar Quadros de Zoom de Seção
Crie uma seção com SectionCollection::addSection, então passe a seção retornada para ShapeCollection::addSectionZoomFrame. Este exemplo coloca um zoom de seção no primeiro slide e o vincula a uma seção que começa com um slide colorido. A posição e as dimensões do quadro são especificadas em pontos, e a apresentação é salva como PPTX.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 154, 205, 50);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$section = $presentation->getSections()->addSection("Section 1", $slide);
$sectionZoomFrame = $overviewSlide->getShapes()->addSectionZoomFrame(20, 20, 300, 200, $section);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Criar Quadros de Zoom de Seção com Imagens Personalizadas
A sobrecarga de imagem de ShapeCollection::addSectionZoomFrame permite exibir uma visualização personalizada sem alterar a seção de destino. Este exemplo requer uma imagem local, que é carregada com Images::fromFile e adicionada através de ImageCollection::addImage. A apresentação salva contém um zoom de seção no primeiro slide vinculado à seção recém‑criada.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Images;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 154, 205, 50);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$image = Images::fromFile("image.png");
try {
$previewImage = $presentation->getImages()->addImage($image);
} finally {
$image->dispose();
}
$section = $presentation->getSections()->addSection("Section 1", $slide);
$sectionZoomFrame = $overviewSlide->getShapes()->addSectionZoomFrame(20, 20, 300, 200, $section, $previewImage);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Alterar a Seção de Destino de um Zoom de Seção
Use SectionZoomFrame::setTargetSection para redirecionar um zoom de seção existente sem recriá‑lo. Escolha uma seção preenchida da coleção Presentation::getSections da mesma apresentação. Atribuir uma seção vazia deixa o destino atual inalterado, portanto verifique Section::getSlidesListOfSection antes de atribuí‑la. Consulte Gerenciar Seções de Slides para mais informações sobre seções.
O exemplo a seguir carrega um arquivo de apresentação, que deve conter várias seções preenchidas, um zoom de seção existente chamado Section navigation e uma seção com o nome exclusivo Results. Ele procura o zoom em todos os slides e encontra o destino pelo nome em vez de por um índice de coleção que pode mudar quando as seções são reordenadas. Se os nomes não forem exclusivos, use Section::getSectionId para identificar o destino.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("section-zoom.pptx");
try {
$zoom = null;
$slideCount = java_values($presentation->getSlides()->size());
for ($i = 0; $i < $slideCount; $i++) {
$slide = $presentation->getSlides()->get_Item($i);
$shapeCount = java_values($slide->getShapes()->size());
for ($j = 0; $j < $shapeCount; $j++) {
$shape = $slide->getShapes()->get_Item($j);
if (java_instanceof($shape, new JavaClass("com.aspose.slides.ISectionZoomFrame")) && java_values($shape->getName()) === "Section navigation") {
$zoom = $shape;
break;
}
}
if ($zoom != null) {
break;
}
}
$targetSection = null;
$sectionCount = java_values($presentation->getSections()->size());
for ($i = 0; $i < $sectionCount; $i++) {
$section = $presentation->getSections()->get_Item($i);
if (java_values($section->getName()) === "Results") {
$targetSection = $section;
break;
}
}
if ($zoom == null || $targetSection == null) {
echo "The section zoom or destination section was not found.", PHP_EOL;
} else if (java_values($targetSection->getSlidesListOfSection()->size()) == 0) {
echo "The destination section is empty.", PHP_EOL;
} else {
$currentSection = $zoom->getTargetSection();
echo "Current section: " . (java_is_null($currentSection) ? "" : java_values($currentSection->getName())), PHP_EOL;
$zoom->setTargetSection($targetSection);
$presentation->save("section-zoom-updated.pptx", SaveFormat::Pptx);
}
} finally {
$presentation->dispose();
}
Formatar Quadros de Zoom de Seção
Este exemplo move e redimensiona um zoom de seção para 100 por 75 pontos, atribui uma imagem local através de ZoomObject::setZoomImage e aplica uma borda marrom tracejada de 2,5 pontos. Ele habilita ZoomObject::setReturnToParent para retornar ao slide de origem após a seção, desabilita ZoomObject::setShowBackground e define ZoomObject::setTransitionDuration para 1,5 segundos. Uma imagem local é necessária para a visualização personalizada.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Images;
use aspose\slides\LineDashStyle;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 154, 205, 50);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$section = $presentation->getSections()->addSection("Section 1", $slide);
$sectionZoomFrame = $overviewSlide->getShapes()->addSectionZoomFrame(20, 20, 300, 200, $section);
$sectionZoomFrame->setX(100);
$sectionZoomFrame->setY(300);
$sectionZoomFrame->setWidth(100);
$sectionZoomFrame->setHeight(75);
$image = Images::fromFile("image.png");
try {
$previewImage = $presentation->getImages()->addImage($image);
} finally {
$image->dispose();
}
$sectionZoomFrame->setZoomImage($previewImage);
$sectionZoomFrame->setReturnToParent(true);
$sectionZoomFrame->setShowBackground(false);
$sectionZoomFrame->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 165, 42, 42);
$sectionZoomFrame->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor($color);
$sectionZoomFrame->getLineFormat()->setDashStyle(LineDashStyle::DashDot);
$sectionZoomFrame->getLineFormat()->setWidth(2.5);
$sectionZoomFrame->setTransitionDuration(1.5);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Zoom de Resumo
Um zoom de resumo fornece uma visão geral das seções da apresentação. Durante a apresentação, você pode usá‑lo para pular para uma seção, avançar ou revisitar um tópico sem seguir a ordem dos slides.

Para objetos de zoom de resumo, o Aspose.Slides fornece as classes SummaryZoomFrame, SummaryZoomSection e SummaryZoomSectionCollection e métodos na classe ShapeCollection.
Criar um Zoom de Resumo
Use ShapeCollection::addSummaryZoomFrame para criar uma visão geral das seções da apresentação. Este exemplo cria quatro seções com fundos de slide distintos e adiciona um zoom de resumo ao primeiro slide. A posição e as dimensões do quadro são especificadas em pontos, e a visão geral resultante é salva em uma apresentação PPTX.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 165, 42, 42);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$presentation->getSections()->addSection("Section 1", $slide);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->CYAN);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$presentation->getSections()->addSection("Section 2", $slide);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 127, 255, 0);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$presentation->getSections()->addSection("Section 3", $slide);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 0, 100, 0);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$presentation->getSections()->addSection("Section 4", $slide);
$summaryZoomFrame = $overviewSlide->getShapes()->addSummaryZoomFrame(150, 50, 300, 200);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Adicionar e Remover uma Seção de Zoom de Resumo
Um zoom de resumo armazena seus objetos SummaryZoomSection em SummaryZoomFrame::getSummaryZoomCollection. Este exemplo cria uma visão geral de duas seções, adiciona uma terceira seção usando SummaryZoomSectionCollection::addSummaryZoomSection e remove a entrada da primeira seção usando SummaryZoomSectionCollection::removeSummaryZoomSection. Remover a entrada deixa a seção da apresentação e seus slides intactos.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 165, 42, 42);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$firstSection = $presentation->getSections()->addSection("Section 1", $slide);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->CYAN);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$presentation->getSections()->addSection("Section 2", $slide);
$summaryZoomFrame = $overviewSlide->getShapes()->addSummaryZoomFrame(150, 50, 300, 200);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 127, 255, 0);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$thirdSection = $presentation->getSections()->addSection("Section 3", $slide);
$summaryZoomFrame->getSummaryZoomCollection()->addSummaryZoomSection($thirdSection);
$summaryZoomFrame->getSummaryZoomCollection()->removeSummaryZoomSection($firstSection);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Formatar Seções de Zoom de Resumo
Este exemplo formata a primeira entrada em SummaryZoomFrame::getSummaryZoomCollection, usando o índice base zero 0. Ele requer uma imagem local para ZoomObject::setZoomImage, aplica uma borda preta tracejada de 1,5 pontos e define ZoomObject::setTransitionDuration para 1,5 segundos. Passar false para ZoomObject::setReturnToParent desabilita o retorno automático ao slide de resumo para esta entrada.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Images;
use aspose\slides\LineDashStyle;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$overviewSlide = $presentation->getSlides()->get_Item(0);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 165, 42, 42);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor($color);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$presentation->getSections()->addSection("Section 1", $slide);
$slide = $presentation->getSlides()->addEmptySlide($overviewSlide->getLayoutSlide());
$slide->getBackground()->getFillFormat()->setFillType(FillType::Solid);
$slide->getBackground()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->CYAN);
$slide->getBackground()->setType(BackgroundType::OwnBackground);
$presentation->getSections()->addSection("Section 2", $slide);
$summaryZoomFrame = $overviewSlide->getShapes()->addSummaryZoomFrame(150, 50, 300, 200);
$summarySection = $summaryZoomFrame->getSummaryZoomCollection()->get_Item(0);
$image = Images::fromFile("image.png");
try {
$previewImage = $presentation->getImages()->addImage($image);
} finally {
$image->dispose();
}
$summarySection->setZoomImage($previewImage);
$summarySection->setReturnToParent(false);
$summarySection->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
$summarySection->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
$summarySection->getLineFormat()->setDashStyle(LineDashStyle::DashDot);
$summarySection->getLineFormat()->setWidth(1.5);
$summarySection->setTransitionDuration(1.5);
$presentation->save("presentation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
FAQ
Posso controlar o retorno ao slide “pai” após exibir o destino?
Sim. Chame ZoomObject::setReturnToParent com true para retornar ao slide de origem após o conteúdo de destino ser exibido.
Posso ajustar a “velocidade” ou duração da transição do Zoom?
Sim. Use ZoomObject::setTransitionDuration para controlar a duração da transição em segundos.
Existem limites para quantos objetos Zoom uma apresentação pode conter?
Não há limite rígido de API documentado. Limites práticos dependem da complexidade geral da apresentação e do desempenho do visualizador. Você pode adicionar muitos quadros de Zoom, mas considere o tamanho do arquivo e o tempo de renderização.