Beheer dia‑secties in presentaties met Java

Waar deze pagina over gaat

Beheer dia‑secties met Aspose.Slides voor Java: maak, hernoem, herschik, haal op en verwerk sectiedia’s in PPTX‑presentaties.

Inleiding

Secties ordenen opeenvolgende dia’s in benoemde groepen zonder de inhoud van de dia’s te wijzigen. Met Aspose.Slides voor Java kun je secties maken, opnieuw ordenen, hernoemen, inspecteren en verwijderen via de Presentation.getSections‑methode.

Secties zijn vooral nuttig wanneer:

een grote presentatie moet worden verdeeld in logische onderwerpen of hoofdstukken;
verschillende groepen dia’s aan verschillende medewerkers worden toegewezen;
dia’s moeten worden verwerkt, verplaatst of samengevoegd als groepen.

Kies beknopte sectienaammen die het doel van de gegroepeerde dia’s beschrijven. Omdat secties deel uitmaken van de presentatiestructuur, gebruik je de sectie‑API’s om lidmaatschap te bepalen in plaats van dit af te leiden uit dia‑posities.

Secties maken en beheren

Gebruik ISectionCollection.addSection om een sectie te maken door de naam en de startdia op te geven. Aspose.Slides bepaalt welke dia’s tot de sectie behoren op basis van de huidige sectiestructuur van de presentatie.

Dezelfde ISectionCollection stelt je ook in staat om:

een sectie samen met de bijbehorende dia’s te verplaatsen met ISectionCollection.reorderSectionWithSlides;
alleen de sectiedefinitie te verwijderen met ISectionCollection.removeSection, waardoor de dia’s behouden blijven;
een sectie en de bijbehorende dia’s te verwijderen met ISectionCollection.removeSectionWithSlides;
een lege sectie aan het einde toe te voegen met ISectionCollection.appendEmptySection.

Het volgende voorbeeld maakt twee secties, verplaatst er één, verwijdert die samen met de bijbehorende dia’s en voegt een lege sectie toe:

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();
}

Na deze bewerkingen bevat de presentatie de sectie Inleiding met de bijbehorende dia’s en een lege sectie Bijlage. De sectie Resultaten en de bijbehorende dia’s zijn verwijderd.

Secties hernoemen

Om een sectie te hernoemen, roep je de ISection.setName‑methode aan. De dia’s en positie van de sectie blijven ongewijzigd.

Het volgende voorbeeld maakt een sectie en wijzigt de naam:

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();
}

Dia’s ophalen uit secties

De Presentation.getSections‑methode retourneert een ISectionCollection die je kunt itereren. Voor elk ISection roep je ISection.getSlidesListOfSection aan om de dia’s te verkrijgen die momenteel tot die sectie behoren. De methode retourneert een ISectionSlideCollection, die een aantal, indextoegang en iteratie biedt.

Het volgende voorbeeld maakt twee gevulde secties en één lege sectie, en drukt vervolgens voor elke sectie de naam , identifier , startdia , het aantal dia’s en de dia‑nummers af. Het gebruikt ISectionSlideCollection.get_Item om de eerste dia te lezen en een verbeterde for‑statement om elke dia te verwerken. Voor de lege sectie heeft de geretourneerde collectie een omvang van nul, wordt de methode niet aangeroepen en voert de iteratie geen bewerkingen uit.

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();
}

Het lidmaatschap van een sectie wordt bepaald door de sectiestructuur van de presentatie. Bereken een sectie‑bereik niet handmatig aan de hand van ISection.getStartedFromSlide, dia‑indexen en de startdia van de volgende sectie.

Structurele bewerkingen kunnen zowel de voor een sectie geretourneerde dia’s als hun dia‑nummers wijzigen. Dit omvat het opnieuw ordenen van dia’s, een dia klonen in een sectie, een sectie samen met de bijbehorende dia’s verplaatsen, dia’s verwijderen en secties verwijderen. Het volgende voorbeeld roept ISection.getSlidesListOfSection aan na elke dergelijke wijziging in plaats van aannames te behouden over de eerdere grenzen van de sectie.

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();
}

Roep ISection.getSlidesListOfSection opnieuw aan telkens wanneer dia’s of secties opnieuw worden geordend, gekloond, verplaatst of verwijderd. Dit zorgt ervoor dat de vervolgverwerking overeenkomt met de huidige presentatiestructuur.

Het PPT‑formaat (PowerPoint 97–2003) behoudt geen sectiemetagegevens. Gebruik deze werkwijze met een formaat dat secties ondersteunt, zoals PPTX; conversie naar PPT verwijdert de sectiestructuur die nodig is voor latere iteratie.

Veelgestelde vragen

Worden secties behouden bij het opslaan in het PPT‑formaat (PowerPoint 97–2003)?

Nee. Het PPT‑formaat ondersteunt geen sectiemetagegevens, waardoor de sectiegroepering verloren gaat bij het opslaan als .ppt.

Kan een gehele sectie “verborgen” worden?

Nee. Een sectie heeft geen zichtbaarheidsstatus. Om de inhoud te verbergen, roep je ISlide.setHidden aan voor elke dia in de sectie.

Hoe kan ik de sectie vinden die een dia bevat?

Itereer over de collectie die wordt geretourneerd door Presentation.getSections, roep voor elke sectie ISection.getSlidesListOfSection aan en vergelijk de geretourneerde dia’s met de doel‑dia. Voor een niet‑lege sectie geeft ISection.getStartedFromSlide de eerste dia terug; voor een lege sectie wordt null geretourneerd.

Beheer tekenrichtlijnen in presentaties in Java