Применение или изменение макетов слайдов в Java

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

Применяйте, создавайте и изменяйте макеты слайдов в Aspose.Slides для Java, добавляйте заполнители, удаляйте неиспользуемые макеты и управляйте видимостью нижнего колонтитула.

Обзор

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

Наиболее распространённые макеты включают:

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

Понимание наследования макетов

Презентация имеет три связанных уровня:

Мастер‑слайд определяет тему, общие параметры форматирования, фон и общие объекты.
Слайд‑макет принадлежит мастеру и определяет конкретное расположение заполнителей.
Обычный слайд использует один макет и сохраняет введённое для этого слайда содержимое.

Обычный слайд наследует тему и форматирование от своего макета, а макет наследуется от своего мастера. Значение, установленное непосредственно на обычном слайде, переопределяет унаследованное значение на этом уровне. При создании обычного слайда его формы‑заполнители генерируются из выбранного макета, тогда как содержимое, введённое в эти заполнители, принадлежит обычному слайду.

Добавьте необходимые заполнители в макет до создания из него слайдов. Добавление ещё одного заполнителя в макет позже не добавит автоматически соответствующую форму‑заполнитель в существующие обычные слайды.

Эти отношения имеют два важных следствия:

Изменение унаследованного форматирования или геометрии существующего заполнителя в макете может обновить каждый слайд, зависящий от него. Прежде чем редактировать макет, который уже используется, проверьте его зависимые слайды и просмотрите получившуюся презентацию.
Макет, который всё ещё используется слайдом, нельзя удалить. Сначала переназначьте его зависимые слайды на другой макет или удалите только неиспользуемые макеты.

Для получения более подробной информации о верхнем уровне этой иерархии смотрите Мастер‑слайд.

Чтобы скрыть унаследованные логотипы или декоративные формы мастера на одном слайде или через общий макет, смотрите Control the Visibility of Master Graphics. В примере сравниваются два слайда, использующие один и тот же мастер.

Выбор и применение макета слайда

Используйте тип макета, когда презентация следует стандартным определениям макетов PowerPoint. Имена макетов редактируются пользователем и могут быть локализованы, поэтому выбор по имени менее надёжен, если вы не контролируете исходный шаблон.

Следующий пример ищет Заголовок и содержание на первом мастере. Если этот макет недоступен, он намеренно переходит к Пустому. Второй проверочный оператор нужен, потому что презентация может содержать только пользовательские макеты. Выбранный макет затем применяется к первому обычному слайду через метод ISlide.setLayoutSlide.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterLayoutSlideCollection layoutSlides = presentation.getMasters().get_Item(0).getLayoutSlides();
    ILayoutSlide targetLayout = layoutSlides.getByType(SlideLayoutType.TitleAndObject);

    if (targetLayout == null) {
        targetLayout = layoutSlides.getByType(SlideLayoutType.Blank);
    }

    if (targetLayout == null) {
        throw new IllegalStateException("The first master does not contain a suitable layout slide.");
    }

    presentation.getSlides().get_Item(0).setLayoutSlide(targetLayout);
    presentation.save("output-with-new-layout.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

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

Добавление макета слайда

Выбор и создание — отдельные операции. Предыдущий пример выбирает существующий макет; он не создаёт его. Чтобы создать макет, вызовите метод IMasterLayoutSlideCollection.add в коллекции макетов целевого мастера.

Следующий пример всегда добавляет новый макет Заголовок и содержание с именем Report Title and Content, затем добавляет обычный слайд на его основе. Имена макетов должны быть уникальны в пределах коллекции.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterSlide masterSlide = presentation.getMasters().get_Item(0);
    ILayoutSlide reportLayout = masterSlide.getLayoutSlides().add(SlideLayoutType.TitleAndObject, "Report Title and Content");
    presentation.getSlides().addEmptySlide(reportLayout);

    presentation.save("output-with-report-layout.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Добавляйте макет только тогда, когда шаблону действительно нужен ещё один переиспользуемый элемент структуры. Если подходящий макет уже существует, выбирайте и переиспользуйте его вместо создания дубликата.

Добавление заполнителей к макету слайда

Метод ILayoutSlide.getPlaceholderManager предоставляет ILayoutPlaceholderManager для добавления форм‑заполнителей в макет.

Заполнитель PowerPoint	Метод ILayoutPlaceholderManager
	`addContentPlaceholder(float x, float y, float width, float height)`
	`addVerticalContentPlaceholder(float x, float y, float width, float height)`
	`addTextPlaceholder(float x, float y, float width, float height)`
	`addVerticalTextPlaceholder(float x, float y, float width, float height)`
	`addPicturePlaceholder(float x, float y, float width, float height)`
	`addChartPlaceholder(float x, float y, float width, float height)`
	`addTablePlaceholder(float x, float y, float width, float height)`
	`addSmartArtPlaceholder(float x, float y, float width, float height)`
	`addMediaPlaceholder(float x, float y, float width, float height)`
	`addOnlineImagePlaceholder(float x, float y, float width, float height)`

Следующий пример проверяет, существует ли макет Пустой, добавляет к нему четыре заполнителя, а затем создаёт обычный слайд, использующий изменённый макет. Порядок преднамерен: заполнители добавляются до создания обычного слайда, чтобы Aspose.Slides мог генерировать соответствующие формы‑заполнители на этом слайде.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ILayoutSlide blankLayout = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);

    if (blankLayout == null) {
        throw new IllegalStateException("The presentation does not contain a Blank layout slide.");
    }

    ILayoutPlaceholderManager placeholderManager = blankLayout.getPlaceholderManager();
    placeholderManager.addContentPlaceholder(20, 20, 310, 270);
    placeholderManager.addVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.addChartPlaceholder(20, 310, 310, 180);
    placeholderManager.addTablePlaceholder(350, 310, 350, 180);

    presentation.getSlides().addEmptySlide(blankLayout);
    presentation.save("output-with-placeholders.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Результат:

Заполнители на макете слайда

Warning

Изменение унаследованного форматирования или геометрии существующих заполнителей в макете может повлиять на зависимые слайды. Ново‑добавленный заполнитель макета не будет автоматически добавлен в существующие обычные слайды. Тестируйте изменения макета на копии презентации и проверяйте каждый зависимый слайд.

Удаление неиспользуемых макетов слайдов

Используйте метод Compress.removeUnusedLayoutSlides для удаления макетов, на которые не ссылается ни один обычный слайд. Метод оставляет макеты, которые всё ещё используются, неизменными.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    Compress.removeUnusedLayoutSlides(presentation);
    presentation.save("output-without-unused-layouts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Чтобы удалить конкретный макет, сначала используйте его метод hasDependingSlides или getDependingSlides. Переназначьте любые зависимые слайды перед вызовом ILayoutSlide.remove. Попытка удалить используемый макет вызывает PptxEditException.

Управление видимостью нижнего колонтитула на макете слайда

У макета есть собственные заполнители нижнего колонтитула, номера слайда и даты/времени. Используйте метод ILayoutSlide.getHeaderFooterManager для управления этими заполнителями в одном макете. Это полезно, когда, например, макеты содержимого должны показывать нижний колонтитул, а макеты заголовка — нет.

Следующий пример безопасно выбирает макет и делает его элементы нижнего колонтитула видимыми:

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.TitleAndObject);

    if (layoutSlide == null) {
        layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);
    }

    if (layoutSlide == null) {
        throw new IllegalStateException("The presentation does not contain a suitable layout slide.");
    }

    ILayoutSlideHeaderFooterManager headerFooterManager = layoutSlide.getHeaderFooterManager();
    headerFooterManager.setFooterVisibility(true);
    headerFooterManager.setSlideNumberVisibility(true);
    headerFooterManager.setDateTimeVisibility(true);
    headerFooterManager.setFooterText("Footer text");
    headerFooterManager.setDateTimeText("Date and time text");

    presentation.save("output-with-layout-footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Управление видимостью нижнего колонтитула на мастере и его дочерних макетах

Чтобы применить согласованные настройки нижнего колонтитула по всей иерархии мастера, используйте метод IMasterSlide.getHeaderFooterManager. Методы распространения IMasterSlideHeaderFooterManager работают с мастером, его зависимыми макетными слайдами и обычными слайдами; они не нацелены только на один обычный слайд.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterSlideHeaderFooterManager headerFooterManager = presentation.getMasters().get_Item(0).getHeaderFooterManager();
    headerFooterManager.setFooterAndChildFootersVisibility(true);
    headerFooterManager.setSlideNumberAndChildSlideNumbersVisibility(true);
    headerFooterManager.setDateTimeAndChildDateTimesVisibility(true);
    headerFooterManager.setFooterAndChildFootersText("Footer text");
    headerFooterManager.setDateTimeAndChildDateTimesText("Date and time text");

    presentation.save("output-with-master-footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

В чём разница между мастер‑слайдом и макетом слайда?

Мастер‑слайд определяет тему презентации и общие параметры форматирования. Макет слайда принадлежит мастеру и определяет одну переиспользуемую раскладку заполнителей. Обычные слайды используют эти макеты и хранят содержание, специфичное для каждого слайда.

Можно ли скопировать макет слайда из одной презентации в другую?

Да. Добавьте копию в целевую коллекцию с помощью метода addClone. При копировании между презентациями также проверьте шрифты, темы, изображения и другие ресурсы, используемые исходным макетом.

Что происходит, когда я изменяю макет, который уже используется?

Зависимые слайды наследуют изменения макета, если они не переопределяют затронутое форматирование или объекты локально. Геометрия заполнителей и унаследованные стили могут измениться сразу на многих слайдах. Используйте getDependingSlides для определения затронутых слайдов перед редактированием макета.

Что произойдёт, если я удалю макет, который всё ещё используется?

Aspose.Slides выбрасывает PptxEditException. Сначала переназначьте зависимые слайды или используйте removeUnusedLayoutSlides для удаления только неиспользуемых макетов.

Сравнение слайдов презентации в Java Управление слайд‑мастерами презентации в Java