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

概述

幻灯片切换控制幻灯片在放映过程中如何出现。使用 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();
}

轮转切换

IWheelTransition 的 setSpokes 方法控制显示目标幻灯片的径向扇区数量。在访问 IWheelTransition 之前,先使用 setType 将幻灯片的切换类型设置为来自 TransitionType 的 Wheel,然后调用 getValue。

此示例创建两对相同的幻灯片:一张黑色幻灯片后跟一张带金色矩形的幻灯片。目标幻灯片使用 1 和 8 的扇区计数,速度通过 setSpeed 设置相同,并通过 setDuration 将显式持续时间设为 8000 毫秒,以便轻松观察差异。

import java.awt.Color;
import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    float slideWidth = (float) presentation.getSlideSize().getSize().getWidth();
    float slideHeight = (float) presentation.getSlideSize().getSize().getHeight();

    ISlide blackSlide = presentation.getSlides().get_Item(0);
    blackSlide.getShapes().clear();
    blackSlide.getBackground().setType(BackgroundType.OwnBackground);
    blackSlide.getBackground().getFillFormat().setFillType(FillType.Solid);
    blackSlide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.BLACK);

    ISlide destinationSlide = presentation.getSlides().addClone(blackSlide);
    IAutoShape rectangle = destinationSlide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, slideWidth, slideHeight);
    rectangle.getFillFormat().setFillType(FillType.Solid);
    Color gold = new Color(255, 215, 0);
    rectangle.getFillFormat().getSolidFillColor().setColor(gold);
    rectangle.getTextFrame().setText("Wheel transition");

    presentation.getSlides().addClone(blackSlide);
    presentation.getSlides().addClone(destinationSlide);

    long[] spokeCounts = { 1, 8 };
    for (int i = 0; i < spokeCounts.length; i++) {
        ISlideShowTransition transition = presentation.getSlides().get_Item(i * 2 + 1).getSlideShowTransition();
        transition.setType(TransitionType.Wheel);
        IWheelTransition wheelTransition = (IWheelTransition) transition.getValue();
        wheelTransition.setSpokes(spokeCounts[i]);
        transition.setSpeed(TransitionSpeed.Slow);
        transition.setDuration(8000);
    }

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

在 PowerPoint 中打开输出演示文稿并运行幻灯片放映。从幻灯片 1 前进到幻灯片 2,再从幻灯片 3 前进到幻灯片 4。在 PowerPoint 播放中,验证后的扇区计数 1 以一次顺时针扫过的方式显示幻灯片;验证后的计数 8 则通过八个径向扇区同时显示。目标内容和切换时机相同,区别仅在于显示扇区的数量。

添加高级幻灯片切换

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

同时启用点击和计时前进,以便观看者可以点击前进或等待计时器。若只使用计时器,请对 setAdvanceOnClick 传入 false。延迟控制幻灯片放映何时前进;它并不设定视觉切换效果的持续时间。

此示例为前三张幻灯片分配不同的效果,并分别在 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 的值来确定效果时长。

Separate bars identify the 750-ms transition duration and 5,000-ms automatic advancement setting.

共享示例为每张幻灯片设置了 750 毫秒的淡入切换,并分别在 5,000 毫秒时启用自动前进。切换时长控制效果,前进时机控制何时离开幻灯片。这些条形图是示意设置,而非测量得到的合成时间线。

对所有幻灯片应用相同的时长

为保持一致的节奏,可对每张幻灯片应用相同的效果和精确时长。此示例加载 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 在可能的情况下按字符匹配文本进行动画。

使用 setType 选择 Morph 后,再访问 getValue。返回的值提供 IMorphTransition 接口,其 setMorphType 方法用于选择匹配模式。

此示例打开前一节创建的演示文稿,并将第二张幻灯片配置为基于词的 Morph 动画。

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 表示未应用任何切换效果。