Управление разделами слайдов в презентациях с помощью Java

О чём эта страница

Управляйте разделами слайдов с помощью Aspose.Slides for Java: создавайте, переименовывайте, переупорядочивайте, получайте и обрабатывайте слайды разделов в PPTX-презентациях.

Введение

Разделы упорядочивают последовательные слайды в именованные группы, не изменяя содержимое слайдов. С помощью Aspose.Slides for Java вы можете создавать, переупорядочивать, переименовывать, просматривать и удалять разделы через метод Presentation.getSections .

Разделы особенно полезны, когда:

крупная презентация должна быть разбита на логические темы или главы;
разные группы слайдов назначаются разным сотрудникам;
слайды требуется обрабатывать, перемещать или объединять группами.

Выбирайте короткие названия разделов, которые описывают назначение сгруппированных слайдов. Поскольку разделы являются частью структуры презентации, используйте API разделов для определения принадлежности, а не выводите её из позиций слайдов.

Создание и управление разделами

Используйте ISectionCollection.addSection для создания раздела, указав его имя и начальный слайд. Aspose.Slides определяет, какие слайды принадлежат разделу, исходя из текущей структуры разделов презентации.

Тот же ISectionCollection также позволяет:

переместить раздел вместе с его слайдами, используя ISectionCollection.reorderSectionWithSlides;
удалить только определение раздела с помощью ISectionCollection.removeSection, сохранив его слайды;
удалить раздел и его слайды с помощью ISectionCollection.removeSectionWithSlides;
добавить пустой раздел в конец с помощью ISectionCollection.appendEmptySection.

Следующий пример создаёт два раздела, перемещает один из них, удаляет его вместе со слайдами и добавляет пустой раздел:

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

После этих операций в презентации будет раздел Introduction со своими слайдами и пустой раздел Appendix. Раздел Results и его слайды будут удалены.

Переименование разделов

Чтобы переименовать раздел, вызовите его метод ISection.setName . Слайды раздела и его позиция останутся без изменений.

Следующий пример создаёт раздел и меняет его имя:

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

Получение слайдов из разделов

Метод Presentation.getSections возвращает ISectionCollection, по которой можно итерировать. Для каждого ISection вызовите ISection.getSlidesListOfSection чтобы получить слайды, которые в данный момент ему принадлежат. Метод возвращает ISectionSlideCollection, предоставляющую количество, доступ по индексу и возможность перебора.

Следующий пример создаёт два заполненных раздела и один пустой, затем выводит для каждого раздела его name, identifier, starting slide, количество слайдов и номера слайдов. Он использует ISectionSlideCollection.get_Item для чтения первого слайда и улучшенный оператор for для обработки каждого слайда. Для пустого раздела возвращаемая коллекция имеет размер ноль, метод не вызывается, и итерация не выполняет никаких операций.

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

Принадлежность к разделу определяется структурой разделов презентации. Не рассчитывайте диапазон раздела вручную, используя ISection.getStartedFromSlide, индексы слайдов и начальный слайд следующего раздела.

Структурные изменения могут изменить как список слайдов, возвращаемый для раздела, так и их номера. Это включает переупорядочивание слайдов, клонирование слайда в раздел, перемещение раздела вместе с его слайдами, удаление слайдов и удаление разделов. В следующем примере после каждого такого изменения вызывается ISection.getSlidesListOfSection вместо сохранения предположений о прежних границах раздела.

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

Вызывайте ISection.getSlidesListOfSection каждый раз, когда слайды или разделы переупорядочиваются, клонируются, перемещаются или удаляются. Это поддерживает согласованность последующей обработки с текущей структурой презентации.

Формат PPT (PowerPoint 97–2003) не сохраняет метаданные разделов. Используйте этот рабочий процесс с форматом, поддерживающим разделы, например PPTX; преобразование в PPT удалит структуру разделов, необходимую для последующего перебора.

FAQ

Сохраняются ли разделы при сохранении в формат PPT (PowerPoint 97–2003)?

Нет. Формат PPT не поддерживает метаданные разделов, поэтому группировка разделов теряется при сохранении в .ppt.

Можно ли полностью «скрыть» раздел?

Нет. У раздела нет состояния видимости. Чтобы скрыть его содержимое, вызовите ISlide.setHidden для каждого слайда в разделе.

Как найти раздел, содержащий конкретный слайд?

Итеративно пройдитесь по коллекции, возвращаемой Presentation.getSections, вызовите ISection.getSlidesListOfSection для каждого раздела и сравните полученные слайды с целевым слайдом. Для непустого раздела ISection.getStartedFromSlide возвращает его первый слайд; для пустого раздела он возвращает null.

Управление направляющими при работе с презентациями в Java