使用 Java 管理演示文稿中的幻灯片切换

本页内容简介

使用 Aspose.Slides for Java 应用幻灯片切换，配置自动幻灯片前进，并自定义 Morph 及其他切换效果。

概述

幻灯片切换控制幻灯片在放映期间的出现方式。使用 Aspose.Slides for Java，您可以为每张幻灯片选择切换效果，配置通过鼠标点击或计时器的前进方式，并调整特定于某个效果的选项。本文使用 Java 示例演示如何应用切换、设置精确的切换持续时间、管理幻灯片计时以及在两张幻灯片之间创建 Morph 切换。示例还展示了如何将设置保存为 PPTX 文件。

添加幻灯片切换

要应用切换，使用 Presentation 类加载演示文稿，并通过 getSlideShowTransition 访问幻灯片的切换设置。使用来自 TransitionType 枚举的值调用 setType，然后保存演示文稿。

下面的示例将 Circle 切换应用于第一张幻灯片，将 Comb 切换应用于第二张幻灯片。使用至少包含两张幻灯片的 input.pptx 文件。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        presentation.getSlides().get_Item(0).getSlideShowTransition().setType(TransitionType.Circle);
        presentation.getSlides().get_Item(1).getSlideShowTransition().setType(TransitionType.Comb);

        presentation.save("slide-transitions.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

添加高级幻灯片切换

您可以配置幻灯片在屏幕上停留的时间以及是否通过鼠标点击来前进幻灯片放映。以下方法可控制此行为：

setAdvanceOnClick 允许观众通过点击鼠标前进。
setAdvanceAfter 启用自动前进。
setAdvanceAfterTime 指定自动前进之前的延迟（毫秒）。

同时启用点击和计时前进，以便观众可以点击继续或等待计时器。若只使用计时器，请将 false 传递给 setAdvanceOnClick。延迟控制幻灯片放映何时前进；它不设置视觉切换效果的持续时间。

下面的示例为前三张幻灯片分配不同的效果，并分别在 3、5、7 秒后启用自动前进。鼠标点击也可以前进这些幻灯片。使用至少包含三张幻灯片的 input.pptx 文件。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 3) {
        ISlideShowTransition firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
        firstTransition.setType(TransitionType.Circle);
        firstTransition.setAdvanceOnClick(true);
        firstTransition.setAdvanceAfter(true);
        firstTransition.setAdvanceAfterTime(3000);

        ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        secondTransition.setType(TransitionType.Comb);
        secondTransition.setAdvanceOnClick(true);
        secondTransition.setAdvanceAfter(true);
        secondTransition.setAdvanceAfterTime(5000);

        ISlideShowTransition thirdTransition = presentation.getSlides().get_Item(2).getSlideShowTransition();
        thirdTransition.setType(TransitionType.Zoom);
        thirdTransition.setAdvanceOnClick(true);
        thirdTransition.setAdvanceAfter(true);
        thirdTransition.setAdvanceAfterTime(7000);

        presentation.save("advanced-transitions.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("The input presentation must contain at least three slides.");
    }
} finally {
    presentation.dispose();
}

要检查是否启用了计时前进，请调用 getAdvanceAfter。仅存储的延迟并不表示计时器已激活。

下一个示例打开上述保存的文件，报告每个已启用的计时器，并对延迟大于两秒的幻灯片禁用自动前进。为这些幻灯片启用鼠标点击并保存更新后的设置。

import com.aspose.slides.*;

Presentation presentation = new Presentation("advanced-transitions.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition transition = slide.getSlideShowTransition();

        if (transition.getAdvanceAfter()) {
            System.out.println("Slide " + slide.getSlideNumber() + ": advance after " + transition.getAdvanceAfterTime() + " ms.");

            if (transition.getAdvanceAfterTime() > 2000) {
                transition.setAdvanceAfter(false);
                transition.setAdvanceOnClick(true);
            }
        }
    }

    presentation.save("adjusted-transitions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

精确控制切换计时

使用 setDuration 指定切换效果的精确长度（毫秒）。幻灯片的 getSlideShowTransition 方法通过 ISlideShowTransition 暴露这些设置：

方法	目的
setDuration	设置切换效果本身的持续时间（毫秒）。
setAdvanceAfterTime	设置幻灯片自动前进之前的延迟（毫秒）。传入 `true` 到 setAdvanceAfter 以激活此计时器。
setSpeed	从 TransitionSpeed（Slow、Medium、Fast）中选择预定义的速度类别。当未指定精确持续时间时使用。

[setDuration] 仅控制切换效果；它不决定幻灯片保持可见的时长。请单独配置自动前进的延迟。如果未设置显式持续时间，Aspose.Slides 会根据切换类型和 [getSpeed] 值确定效果时长。

对每张幻灯片应用相同的持续时间

为保持节奏一致，对每张幻灯片应用相同的效果和精确的持续时间。本示例加载 input.pptx，从 TransitionType 中选择 Fade，并为每个切换设置 750 毫秒的持续时间。它分别在 5,000 毫秒后启用自动前进，并禁用鼠标点击前进，然后将结果保存为 PPTX。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition transition = slide.getSlideShowTransition();
        transition.setType(TransitionType.Fade);
        transition.setDuration(750);

        // 配置自动前进，与效果持续时间无关。
        transition.setAdvanceAfter(true);
        transition.setAdvanceAfterTime(5000);
        transition.setAdvanceOnClick(false);
    }

    presentation.save("precise-transitions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

为单个幻灯片设置不同的持续时间

不同幻灯片可以使用不同的效果持续时间。例如，对标题幻灯片使用简短的切换，对章节介绍使用更长的切换。本示例为第一张幻灯片设置 500 毫秒，为第二张幻灯片设置 1,200 毫秒。使用至少包含两张幻灯片的 input.pptx 文件。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        ISlideShowTransition firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
        firstTransition.setType(TransitionType.Fade);
        firstTransition.setDuration(500);

        ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        secondTransition.setType(TransitionType.Push);
        secondTransition.setDuration(1200);

        presentation.save("individual-transition-durations.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

将切换与动画输出协调

在准备 animated GIF、HTML5 presentation 或 video 时，导出前先设置精确的切换持续时间，以匹配预期的节奏。例如，在场景之间使用 600 毫秒的淡入淡出，并分别调整每张幻灯片的前进延迟，以留出旁白或内容的时间。

对于 GIF 和视频，需要将输出帧率与效果持续时间对应：600 毫秒相当于 30 帧每秒下的 18 帧。HTML5 中请在导出设置中启用动画切换。检查所选导出格式支持的效果和计时选项，并预览输出以确认同步。

读取已存在的切换持续时间

在修改切换之前调用 getDuration，以确定是否存储了显式值。值为 -1 表示未设置显式持续时间；非负值表示以毫秒为单位的存储持续时间。未设置的值并非计算得到的播放时长：Aspose.Slides 使用切换类型和 [getSpeed] 值来确定该时长。设置切换类型可能会初始化持续时间，因此请先检查原始设置。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition transition = slide.getSlideShowTransition();
        int duration = transition.getDuration();

        if (duration >= 0) {
            System.out.println("Slide " + slide.getSlideNumber() + ": stored transition duration is " + duration + " ms.");
        } else {
            System.out.println("Slide " + slide.getSlideNumber() + ": no explicit duration; timing depends on transition type " + transition.getType() + " and speed " + transition.getSpeed() + ".");
        }
    }
} finally {
    presentation.dispose();
}

Morph 切换

Morph 切换在连续幻灯片之间动画化对象的变化。要创建简单的 Morph 效果，克隆一张幻灯片，在克隆上移动或调整对象大小，然后对第二张幻灯片应用 Morph 切换。这使得对应的对象在原始状态和修改后状态之间进行动画。

下面的示例创建一个包含文本矩形的幻灯片，克隆该幻灯片，并在克隆上更改矩形的位置和大小。随后为第二张幻灯片从 TransitionType 中选择 Morph。使用支持 Morph 的演示文稿查看器打开保存的文件，即可在放映时看到效果。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);
    IAutoShape rectangle = firstSlide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 100);
    rectangle.getTextFrame().setText("Morph transition");

    ISlide secondSlide = presentation.getSlides().addClone(firstSlide);
    IShape movedRectangle = secondSlide.getShapes().get_Item(0);
    movedRectangle.setX(movedRectangle.getX() + 100);
    movedRectangle.setY(movedRectangle.getY() + 50);
    movedRectangle.setWidth(movedRectangle.getWidth() - 200);
    movedRectangle.setHeight(movedRectangle.getHeight() - 10);

    secondSlide.getSlideShowTransition().setType(TransitionType.Morph);

    presentation.save("morph-transition.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Morph 切换类型

TransitionMorphType 枚举控制 Morph 如何匹配并动画化内容：

ByObject 将每个形状视为整体对象。
ByWord 在可能的情况下通过匹配单词来动画化文本。
ByChar 在可能的情况下通过匹配字符来动画化文本。

在访问 getValue 之前使用 setType 选择 Morph。该值随后提供 IMorphTransition 接口，其 setMorphType 方法选择匹配模式。

import com.aspose.slides.*;

Presentation presentation = new Presentation("morph-transition.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        ISlideShowTransition transition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        transition.setType(TransitionType.Morph);
        ITransitionValueBase transitionValue = transition.getValue();

        if (transitionValue instanceof IMorphTransition) {
            IMorphTransition morphTransition = (IMorphTransition) transitionValue;
            morphTransition.setMorphType(TransitionMorphType.ByWord);
            presentation.save("morph-by-word.pptx", SaveFormat.Pptx);
        } else {
            System.out.println("Morph transition options are unavailable.");
        }
    } else {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

设置切换效果

某些切换暴露额外选项，例如方向或是否从黑屏开始。可用选项取决于使用 setType 选择的切换。先设置类型，然后使用 getValue 提供的相应接口。

下面的示例对 input.pptx 的第一张幻灯片应用 Cut 切换。它通过 IOptionalBlackTransition 调用 setFromBlack，使切换从黑屏开始。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ISlideShowTransition transition = presentation.getSlides().get_Item(0).getSlideShowTransition();
    transition.setType(TransitionType.Cut);
    ITransitionValueBase transitionValue = transition.getValue();

    if (transitionValue instanceof IOptionalBlackTransition) {
        IOptionalBlackTransition cutTransition = (IOptionalBlackTransition) transitionValue;
        cutTransition.setFromBlack(true);
        presentation.save("cut-from-black.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("Cut transition options are unavailable.");
    }
} finally {
    presentation.dispose();
}

常见问题

我可以控制幻灯片切换的播放速度吗？

可以。当您需要以毫秒为单位的精确效果时，请优先使用 setDuration。如果预定义的 TransitionSpeed（Slow、Medium、Fast）类别足够且未设置显式持续时间，请使用 setSpeed。这些设置独立于自动前进延迟，专门控制切换效果。

我可以为切换附加音频并使其循环吗？

可以。使用 setSound 分配嵌入的音频，传入来自 TransitionSoundMode 枚举的 StartSound 给 setSoundMode，并将 setSoundLoop 设置为 true。音频将循环，直至幻灯片放映中的下一个声音事件。

将相同切换快速应用于每张幻灯片的最快方法是什么？

遍历演示文稿的 getSlides 集合，对每张幻灯片的切换调用 setType 并传入相同的值。在同一循环中设置任何计时和效果选项，以保持所有幻灯片行为一致。

我如何检查幻灯片上当前设置的切换是什么？

对幻灯片的 getSlideShowTransition 结果调用 getType 即可。它返回 TransitionType 枚举中的值；None 表示未应用任何切换效果。

用 Java 管理演示文稿幻灯片母版在 Java 中管理演示文稿的绘图参考线