Diapositiva

Este artículo ofrece una serie de ejemplos que demuestran cómo trabajar con diapositivas utilizando Aspose.Slides for PHP via Java. Aprenderá a añadir, acceder, clonar, reordenar y eliminar diapositivas mediante la clase Presentation.

Cada ejemplo a continuación incluye una breve explicación seguida de un fragmento de código en PHP.

Añadir una diapositiva

Para añadir una nueva diapositiva, primero debe seleccionar una disposición. En este ejemplo, utilizamos la disposición Blank y añadimos una diapositiva vacía a la presentación.

function addSlide() {
    $presentation = new Presentation();
    try {
        // Cada diapositiva se basa en una disposición, que a su vez se basa en una diapositiva maestra.
        // Utilice la disposición Blank para crear una nueva diapositiva.
        $blankLayout = $presentation->getLayoutSlides()->getByType(SlideLayoutType::Blank);

        // Añada una nueva diapositiva vacía usando la disposición seleccionada.
        $presentation->getSlides()->addEmptySlide($blankLayout);

        $presentation->save("slide.pptx", SaveFormat::Pptx);
    } finally {
        $presentation->dispose();
    }
}

💡 Consejo: Cada disposición de diapositiva se deriva de una diapositiva maestra, que define el diseño general y la estructura de los marcadores de posición. La imagen a continuación ilustra cómo se organizan las diapositivas maestras y sus disposiciones asociadas en PowerPoint.

Acceder a diapositivas por índice

function accessSlide() {
    $presentation = new Presentation("slide.pptx");
    try {
        // Acceda a una diapositiva por índice.
        $firstSlide = $presentation->getSlides()->get_Item(0);
    } finally {
        $presentation->dispose();
    }
}

Clonar una diapositiva

function cloneSlide() {
    // Por defecto, la presentación contiene una diapositiva vacía.
    $presentation = new Presentation();
    try {
        $slide = $presentation->getSlides()->get_Item(0);

        // Clona la primera diapositiva; se añadirá al final de la presentación.
        $clonedSlide = $presentation->getSlides()->addClone($slide);

        // El índice de la diapositiva clonada es 1 (segunda diapositiva en la presentación).
        $clonedSlideIndex = $presentation->getSlides()->indexOf($clonedSlide);

        $presentation->save("slide_cloned.pptx", SaveFormat::Pptx);
    } finally {
        $presentation->dispose();
    }
}

Reordenar diapositivas

function reorderSlide() {
    $presentation = new Presentation("slide.pptx");
    try {
        $slide = $presentation->getSlides()->get_Item(1);

        // Mueve la diapositiva a la primera posición (las demás se desplazan hacia abajo).
        $presentation->getSlides()->reorder(0, $slide);

        $presentation->save("slide_reordered.pptx", SaveFormat::Pptx);
    } finally {
        $presentation->dispose();
    }
}

Eliminar una diapositiva

Para eliminar una diapositiva, simplemente haga referencia a ella y llame a remove. Este ejemplo elimina diapositivas por índice y por referencia.

function removeSlide() {
    $presentation = new Presentation("slide.pptx");
    try {
        // Eliminar una diapositiva por índice.
        $presentation->getSlides()->removeAt(0);

        // Eliminar una diapositiva por referencia.
        $slide = $presentation->getSlides()->get_Item(0);
        $presentation->getSlides()->remove($slide);

        $presentation->save("slides_removed.pptx", SaveFormat::Pptx);
    } finally {
        $presentation->dispose();
    }
}