Verwalten von Folienabschnitten in Präsentationen mit Java

Worum es auf dieser Seite geht

Verwalten Sie Folienabschnitte mit Aspose.Slides für Java: Erstellen, umbenennen, neu anordnen, abrufen und verarbeiten von Abschnittsfolien in PPTX‑Präsentationen.

Einleitung

Abschnitte organisieren aufeinanderfolgende Folien in benannte Gruppen, ohne den Folieninhalt zu verändern. Mit Aspose.Slides für Java können Sie Abschnitte über die Methode Presentation.getSections erstellen, neu anordnen, umbenennen, prüfen und entfernen.

Abschnitte sind besonders nützlich, wenn:

eine große Präsentation in logische Themen oder Kapitel unterteilt werden muss;
verschiedene Foliengruppen unterschiedlichen Mitwirkenden zugewiesen werden;
Folien als Gruppen verarbeitet, verschoben oder zusammengeführt werden sollen.

Wählen Sie knappe Abschnittsnamen, die den Zweck der gruppierten Folien beschreiben. Da Abschnitte Teil der Präsentationsstruktur sind, verwenden Sie die Abschnitt‑APIs, um die Zugehörigkeit zu bestimmen, anstatt sie aus den Folienpositionen abzuleiten.

Abschnitte erstellen und verwalten

Verwenden Sie ISectionCollection.addSection, um einen Abschnitt zu erstellen, indem Sie dessen Namen und die Startfolie angeben. Aspose.Slides ermittelt, welche Folien zum Abschnitt gehören, anhand der aktuellen Abschnittsstruktur der Präsentation.

Die gleiche ISectionCollection ermöglicht Ihnen außerdem:

einen Abschnitt zusammen mit seinen Folien zu verschieben, indem Sie ISectionCollection.reorderSectionWithSlides verwenden;
nur die Abschnittsdefinition zu entfernen mit ISectionCollection.removeSection, wobei die Folien erhalten bleiben;
einen Abschnitt samt seinen Folien zu entfernen mit ISectionCollection.removeSectionWithSlides;
einen leeren Abschnitt am Ende hinzuzufügen mit ISectionCollection.appendEmptySection.

Das folgende Beispiel erstellt zwei Abschnitte, verschiebt einen davon, entfernt ihn zusammen mit seinen Folien und hängt einen leeren Abschnitt an:

import com.aspose.slides.ILayoutSlide;
import com.aspose.slides.ISection;
import com.aspose.slides.ISlide;
import com.aspose.slides.Presentation;

Presentation presentation = new Presentation();
try {
    ISlide titleSlide = presentation.getSlides().get_Item(0);
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().get_Item(0);
    presentation.getSlides().addEmptySlide(layoutSlide);
    ISlide resultsSlide = presentation.getSlides().addEmptySlide(layoutSlide);
    presentation.getSlides().addEmptySlide(layoutSlide);

    presentation.getSections().addSection("Introduction", titleSlide);
    ISection resultsSection = presentation.getSections().addSection("Results", resultsSlide);

    presentation.getSections().reorderSectionWithSlides(resultsSection, 0);
    presentation.getSections().removeSectionWithSlides(resultsSection);
    presentation.getSections().appendEmptySection("Appendix");
} finally {
    presentation.dispose();
}

Nach diesen Vorgängen enthält die Präsentation den Abschnitt Introduction mit seinen Folien sowie einen leeren Abschnitt Appendix. Der Abschnitt Results und seine Folien wurden entfernt.

Abschnitte umbenennen

Um einen Abschnitt umzubenennen, rufen Sie dessen Methode ISection.setName auf. Die Folien des Abschnitts und seine Position bleiben unverändert.

Das folgende Beispiel erstellt einen Abschnitt und ändert dessen Namen:

import com.aspose.slides.ISection;
import com.aspose.slides.Presentation;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ISection section = presentation.getSections().addSection("Overview", slide);
    section.setName("Introduction");
} finally {
    presentation.dispose();
}

Folien aus Abschnitten abrufen

Die Methode Presentation.getSections gibt eine ISectionCollection zurück, über die Sie iterieren können. Für jedes ISection rufen Sie ISection.getSlidesListOfSection auf, um die Folien zu erhalten, die derzeit zu diesem Abschnitt gehören. Die Methode liefert eine ISectionSlideCollection, die eine Zählung, indexierten Zugriff und Iteration bereitstellt.

Das folgende Beispiel erstellt zwei gefüllte Abschnitte und einen leeren Abschnitt und gibt anschließend für jeden Abschnitt den Namen, die Kennung, die Startfolie, die Folienanzahl und die Foliennummern aus. Es verwendet ISectionSlideCollection.get_Item zum Lesen der ersten Folie und eine erweiterte for‑Anweisung, um jede Folie zu verarbeiten. Für den leeren Abschnitt hat die zurückgegebene Sammlung die Größe null, die Methode wird nicht aufgerufen und die Iteration führt keine Operationen aus.

import com.aspose.slides.ILayoutSlide;
import com.aspose.slides.ISection;
import com.aspose.slides.ISectionSlideCollection;
import com.aspose.slides.ISlide;
import com.aspose.slides.Presentation;

Presentation presentation = new Presentation();
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().get_Item(0);
    presentation.getSlides().addEmptySlide(layoutSlide);
    ISlide thirdSlide = presentation.getSlides().addEmptySlide(layoutSlide);

    presentation.getSections().addSection("Introduction", firstSlide);
    presentation.getSections().addSection("Details", thirdSlide);
    presentation.getSections().appendEmptySection("Appendix");

    for (ISection section : presentation.getSections()) {
        ISectionSlideCollection sectionSlides = section.getSlidesListOfSection();
        String startingSlide = section.getStartedFromSlide() == null ? "none" : Integer.toString(section.getStartedFromSlide().getSlideNumber());

        System.out.println("Section: " + section.getName());
        System.out.println("ID: " + section.getSectionId());
        System.out.println("Starting slide: " + startingSlide);
        System.out.println("Slide count: " + sectionSlides.size());

        if (sectionSlides.size() > 0) {
            System.out.println("First slide via get_Item: " + sectionSlides.get_Item(0).getSlideNumber());
        }

        System.out.print("Slide numbers:");
        for (ISlide slide : sectionSlides) {
            System.out.print(" " + slide.getSlideNumber());
        }
        System.out.println();
    }
} finally {
    presentation.dispose();
}

Die Zugehörigkeit zu einem Abschnitt wird durch die Abschnittsstruktur der Präsentation bestimmt. Berechnen Sie den Bereich eines Abschnitts nicht manuell aus ISection.getStartedFromSlide, Folienindizes und der Startfolie des nächsten Abschnitts.

Strukturelle Änderungen können sowohl die für einen Abschnitt zurückgegebenen Folien als auch deren Foliennummern ändern. Dazu gehören das Neuordnen von Folien, das Klonen einer Folie in einen Abschnitt, das Verschieben eines Abschnitts zusammen mit seinen Folien, das Entfernen von Folien und das Entfernen von Abschnitten. Das nächste Beispiel ruft nach jeder solchen Änderung ISection.getSlidesListOfSection erneut auf, anstatt Annahmen über frühere Grenzen des Abschnitts beizubehalten.

import com.aspose.slides.ILayoutSlide;
import com.aspose.slides.ISection;
import com.aspose.slides.ISectionSlideCollection;
import com.aspose.slides.ISlide;
import com.aspose.slides.Presentation;

import java.util.function.BiConsumer;

Presentation presentation = new Presentation();
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().get_Item(0);
    presentation.getSlides().addEmptySlide(layoutSlide);
    ISlide thirdSlide = presentation.getSlides().addEmptySlide(layoutSlide);
    presentation.getSlides().addEmptySlide(layoutSlide);
    ISection firstSection = presentation.getSections().addSection("First", firstSlide);
    ISection secondSection = presentation.getSections().addSection("Second", thirdSlide);

    BiConsumer<String, ISection> printSectionSlides = (label, section) -> {
        ISectionSlideCollection sectionSlides = section.getSlidesListOfSection();
        System.out.printf("%s (%d slides):", label, sectionSlides.size());
        for (ISlide slide : sectionSlides) {
            System.out.print(" " + slide.getSlideNumber());
        }
        System.out.println();
    };

    printSectionSlides.accept("Initially", firstSection);

    ISectionSlideCollection slidesBeforeClone = firstSection.getSlidesListOfSection();
    presentation.getSlides().addClone(slidesBeforeClone.get_Item(0), firstSection);
    printSectionSlides.accept("After cloning into the section", firstSection);

    ISectionSlideCollection slidesBeforeReorder = firstSection.getSlidesListOfSection();
    int firstSectionPosition = slidesBeforeReorder.get_Item(0).getSlideNumber() - 1;
    presentation.getSlides().reorder(firstSectionPosition, slidesBeforeReorder.get_Item(slidesBeforeReorder.size() - 1));
    printSectionSlides.accept("After reordering slides", firstSection);

    presentation.getSections().reorderSectionWithSlides(firstSection, 1);
    printSectionSlides.accept("After moving the section", firstSection);

    ISectionSlideCollection slidesBeforeRemoval = firstSection.getSlidesListOfSection();
    presentation.getSlides().remove(slidesBeforeRemoval.get_Item(0));
    printSectionSlides.accept("After removing a slide", firstSection);

    presentation.getSections().removeSectionWithSlides(secondSection);
    for (ISection section : presentation.getSections()) {
        printSectionSlides.accept("Remaining section", section);
    }
} finally {
    presentation.dispose();
}

Rufen Sie ISection.getSlidesListOfSection jedes Mal erneut auf, wenn Folien oder Abschnitte neu angeordnet, geklont, verschoben oder entfernt werden. Dadurch bleibt die nachfolgende Verarbeitung an die aktuelle Präsentationsstruktur angepasst.

Das PPT‑Format (PowerPoint 97–2003) bewahrt keine Abschnitts‑Metadaten. Verwenden Sie diesen Ablauf mit einem Format, das Abschnitte unterstützt, z. B. PPTX; das Konvertieren nach PPT entfernt die Abschnittsstruktur, die für eine spätere Iteration benötigt wird.

FAQ

Werden Abschnitte beim Speichern im PPT‑Format (PowerPoint 97–2003) erhalten?

Nein. Das PPT‑Format unterstützt keine Abschnitts‑Metadaten, sodass die Gruppierung von Abschnitten beim Speichern als .ppt verloren geht.

Kann ein kompletter Abschnitt „ausgeblendet“ werden?

Nein. Ein Abschnitt besitzt keinen Sichtbarkeitsstatus. Um dessen Inhalte auszublenden, rufen Sie für jede Folie im Abschnitt ISlide.setHidden auf.

Wie finde ich den Abschnitt, der eine bestimmte Folie enthält?

Iterieren Sie über die Sammlung, die von Presentation.getSections zurückgegeben wird, rufen Sie für jeden Abschnitt ISection.getSlidesListOfSection auf und vergleichen Sie die zurückgegebenen Folien mit der Ziel‑Fol ie. Für einen nicht leeren Abschnitt liefert ISection.getStartedFromSlide seine erste Folie; für einen leeren Abschnitt liefert er null.

Verwalten von Zeichenhilfen in Präsentationen in Java