.NET 操作 PowerPoint COM 组件：从零到精通的幻灯片制作实战

动画与切换效果编程

问题

静态幻灯片在做演示时可以工作，但适度的动画能引导观众注意力——标题先出现、图表后展示、结论逐行强调。PowerPoint 的动画系统分为两层：形状级别的动画效果（进入/强调/退出）和幻灯片级别的切换效果。

MudTools 通过 IPowerPointTimeLine、IPowerPointEffect、IPowerPointTiming 和 IPowerPointSlideShowTransition 四组接口覆盖了整个动画编程模型。

动画编程模型概览

mermaid

graph TD
    Slide["IPowerPointSlide"]
    TL["IPowerPointTimeLine"]
    MS["MainSequence<br/>IPowerPointSequence"]
    IS["InteractiveSequences<br/>IPowerPointSequences"]
    Effect["IPowerPointEffect"]
    Timing["IPowerPointTiming"]
    Behavior["IPowerPointAnimationBehavior"]
    Motion["IPowerPointMotionEffect"]
    ColorEff["IPowerPointColorEffect"]
    ScaleEff["IPowerPointScaleEffect"]
    RotEff["IPowerPointRotationEffect"]

    Slide --> TL
    TL --> MS
    TL --> IS
    MS --> Effect
    Effect --> Timing
    Effect --> Behavior
    Behavior --> Motion
    Behavior --> ColorEff
    Behavior --> ScaleEff
    Behavior --> RotEff

每张幻灯片都有一个 TimeLine，其中包含 MainSequence（主序列，按时间轴顺序播放）和 InteractiveSequences（交互序列，通过点击触发）。

添加进入动画

进入动画是形状出现时的效果。最常用的几种动画类型通过 MsoAnimEffect 枚举控制：

csharp

using var app = PowerPointFactory.BlankDocument();
var pres = app.ActivePresentation;
var slide = pres.AddSlide(PpSlideLayout.ppLayoutBlank);

var box = slide.Shapes.AddShape(
    MsoAutoShapeType.msoShapeRectangle,
    100, 100, 200, 100);
box.TextFrame.TextRange.Text = "动画目标";

// 获取幻灯片的时间线，在主序列中添加效果
var timeline = slide.TimeLine;
var mainSeq = timeline.MainSequence;

// 添加"飞入"动画（从左侧进入）
var effect = mainSeq.AddEffect(
    box,                           // 形状
    MsoAnimEffect.msoAnimEffectFly,// 动画类型
    default,                       // 动画效果参数
    MsoAnimTriggerType.msoAnimTriggerOnPageClick  // 触发方式
);

// 配置动画计时
effect.Timing.Duration = 0.5f;     // 持续 0.5 秒
effect.Timing.Speed = 0.75f;      // 速度倍率
effect.Timing.SmoothStart = 0.25f; // 缓入
effect.Timing.SmoothEnd = 0.25f;   // 缓出

常用 MsoAnimEffect 进入动画：

枚举	效果
`msoAnimEffectAppear`	出现
`msoAnimEffectFly`	飞入（默认从底部，可以改方向）
`msoAnimEffectFade`	淡入
`msoAnimEffectSplit`	劈裂
`msoAnimEffectWipe`	擦除
`msoAnimEffectShape`	形状
`msoAnimEffectWheel`	轮子
`msoAnimEffectRandomBars`	随机线条
`msoAnimEffectGrowAndTurn`	缩放旋转
`msoAnimEffectZoom`	缩放
`msoAnimEffectSwivel`	回旋
`msoAnimEffectBounce`	弹跳

强调与退出动画

MsoAnimEffect 枚举包含了进入、强调、退出三类。通过 Effect.Exit 属性区分：

csharp

// 强调动画——让形状脉冲一次
var emphasisEffect = mainSeq.AddEffect(
    box,
    MsoAnimEffect.msoAnimEffectPulse  // 脉冲强调
);

// 退出动画——形状淡出
var exitEffect = mainSeq.AddEffect(
    box,
    MsoAnimEffect.msoAnimEffectFade
);
exitEffect.Exit = true;  // 标记为退出动画

触发器控制

三种触发方式：

触发方式	说明
`msoAnimTriggerOnPageClick`	点击鼠标
`msoAnimTriggerAfterPrevious`	上一个动画之后自动播放
`msoAnimTriggerWithPrevious`	与上一个动画同时播放

csharp

// 自动播放：上一个动画结束后延迟 1 秒
effect.Timing.TriggerType = MsoAnimTriggerType.msoAnimTriggerAfterPrevious;
effect.Timing.TriggerDelayTime = 1.0f;

// 与上一个动画同步播放
effect2.Timing.TriggerType = MsoAnimTriggerType.msoAnimTriggerWithPrevious;

// 点击触发（默认）
effect3.Timing.TriggerType = MsoAnimTriggerType.msoAnimTriggerOnPageClick;

多动画时间轴编排

真实场景里，标题、正文、图表不会同时出现。通常编排顺序是：标题先飞入 → 正文再淡入 → 图表最后出现。

csharp

var titleBox = slide.Shapes.AddTextbox(
    MsoTextOrientation.msoTextOrientationHorizontal,
    50, 30, 600, 60);
titleBox.TextFrame.TextRange.Text = "2026 年度报告";

var bodyBox = slide.Shapes.AddTextbox(
    MsoTextOrientation.msoTextOrientationHorizontal,
    50, 120, 600, 300);
bodyBox.TextFrame.TextRange.Text = "核心数据摘要...";

var tableShape = slide.Shapes.AddTable(4, 3, 50, 350, 600, 150);

var mainSeq = slide.TimeLine.MainSequence;

// 标题：从上飞入，自动播放（与页面加载同时）
var titleEffect = mainSeq.AddEffect(
    titleBox,
    MsoAnimEffect.msoAnimEffectFly,
    effectParameter: default,
    MsoAnimTriggerType.msoAnimTriggerWithPrevious);
titleEffect.Timing.Duration = 0.4f;

// 正文：淡入，在标题之后自动播放
var bodyAnim = mainSeq.AddEffect(
    bodyBox,
    MsoAnimEffect.msoAnimEffectFade,
    default,
    MsoAnimTriggerType.msoAnimTriggerAfterPrevious);
bodyAnim.Timing.Duration = 0.6f;

// 表格：缩放进入，在正文之后自动播放
var tableAnim = mainSeq.AddEffect(
    tableShape,
    MsoAnimEffect.msoAnimEffectZoom,
    default,
    MsoAnimTriggerType.msoAnimTriggerAfterPrevious);
tableAnim.Timing.Duration = 0.5f;

mermaid

timeline
    title 标题飞入 : 0-0.4s
    body 正文淡入 : 0.4-1.0s
    table 表格缩放 : 1.0-1.5s

幻灯片切换效果

切换效果是针对整张幻灯片的过渡动画。通过 slide.SlideShowTransition 控制：

csharp

// 设置切换效果
var transition = slide.SlideShowTransition;
transition.EntryEffect = PpEntryEffect.ppEffectFade;          // 淡入淡出
transition.Speed = PpTransitionSpeed.ppTransitionSpeedMedium; // 中速
transition.Duration = 1.5f;                                    // 持续时间

// 自动翻页设置
transition.AdvanceOnClick = true;   // 点击翻页
transition.AdvanceOnTime = true;    // 定时翻页
transition.AdvanceTime = 5.0f;      // 5 秒后自动翻页

// 隐藏幻灯片（在放映时跳过）
transition.Hidden = false;

常见 PpEntryEffect 切换效果：

枚举	效果
`ppEffectNone`	无效果
`ppEffectFade`	淡入淡出
`ppEffectCut`	切出
`ppEffectPushDown/Left/Right/Up`	推入
`ppEffectWipeDown/Left/Right/Up`	擦除
`ppEffectFlyFromLeft/Right/Top/Bottom`	飞入
`ppEffectCoverLeft/Right/Up/Down`	覆盖
`ppEffectUncoverLeft/Right/Up/Down`	揭开
`ppEffectRandom`	随机
`ppEffectDissolve`	溶解
`ppEffectZoomIn/Out`	缩放

PpTransitionSpeed 速度枚举：

枚举	说明
`ppTransitionSpeedSlow`	慢速（约 2s）
`ppTransitionSpeedMedium`	中速（约 1s）
`ppTransitionSpeedFast`	快速（约 0.5s）

动画效果参数配置

部分动画支持进一步的参数调节，通过 EffectParameters 和 Behaviors 实现：

csharp

// 飞入动画的方向控制
effect.EffectParameters.Direction = msoAnimDirectionFromLeft;

// 通过 Behavior 配置运动路径
var behavior = effect.Behaviors.Add(MsoAnimType.msoAnimTypeMotion);
var motion = behavior.MotionEffect;
motion.Path = "M 0 0 L 200 0";  // 水平移动 200pt
motion.FromX = 0;
motion.ToX = 200;

完整示例：综合动画演示

csharp

using MudTools.OfficeInterop;
using MudTools.OfficeInterop.PowerPoint;
using MsCore = Microsoft.Office.Core;

using var app = PowerPointFactory.BlankDocument();
var pres = app.ActivePresentation;

// 第一页：切换效果
var slide1 = pres.GetSlide(1);
slide1.Shapes.Title.TextFrame.TextRange.Text = "动画演示";
slide1.SlideShowTransition.EntryEffect = PpEntryEffect.ppEffectFade;
slide1.SlideShowTransition.Speed = PpTransitionSpeed.ppTransitionSpeedMedium;

// 第二页：复杂动画
var slide2 = pres.AddSlide(PpSlideLayout.ppLayoutBlank);
slide2.SlideShowTransition.EntryEffect = PpEntryEffect.ppEffectPushLeft;

var title = slide2.Shapes.AddTextbox(
    MsCore.MsoTextOrientation.msoTextOrientationHorizontal,
    100, 50, 500, 60);
title.TextFrame.TextRange.Text = "点击后出现";
title.TextFrame.TextRange.Font.Size = 36;
title.TextFrame.TextRange.Font.Bold = true;

var desc = slide2.Shapes.AddTextbox(
    MsCore.MsoTextOrientation.msoTextOrientationHorizontal,
    100, 150, 500, 200);
desc.TextFrame.TextRange.Text = "这是自动播放的描述文字，\n会在标题出现后自动淡入。";

var timeline = slide2.TimeLine;
var mainSeq = timeline.MainSequence;

// 标题：点击触发、飞入
var titleEffect = mainSeq.AddEffect(
    title,
    MsoAnimEffect.msoAnimEffectFly,
    default,
    MsoAnimTriggerType.msoAnimTriggerOnPageClick);
titleEffect.Timing.Duration = 0.5f;
titleEffect.EffectParameters.Direction = 1; // msoAnimDirectionFromTop

// 正文：标题之后自动出现
var descEffect = mainSeq.AddEffect(
    desc,
    MsoAnimEffect.msoAnimEffectFade,
    default,
    MsoAnimTriggerType.msoAnimTriggerAfterPrevious);
descEffect.Timing.Duration = 0.6f;

Console.WriteLine("动画设置完成。按回车退出...");
Console.ReadLine();

注意事项

每个形状在每个 Sequence 中只能添加一次效果。如果想添加多个不同效果，需要创建新形状或使用多条 Sequence。
动画播放顺序依赖 MainSequence 中效果的顺序。MoveTo、MoveBefore、MoveAfter 可以重新排序。
时间单位是秒。Duration、TriggerDelayTime、AdvanceTime 的单位都是秒，float 类型。
EffectParameters.Direction 的值依赖动画类型，不同动画的方向枚举可能不同。建议对照 PPT 录制宏来确认具体数值。

下一篇文章从单页动画上升到演示文稿的整体结构——母版、模板、自定义版式，这是批量生成标准化文档的核心能力。

.NET 操作 PowerPoint COM 组件：从零到精通的幻灯片制作实战 ​

动画与切换效果编程 ​

问题 ​

动画编程模型概览 ​

添加进入动画 ​

强调与退出动画 ​

触发器控制 ​

多动画时间轴编排 ​

幻灯片切换效果 ​

动画效果参数配置 ​

完整示例：综合动画演示 ​

注意事项 ​

.NET 操作 PowerPoint COM 组件：从零到精通的幻灯片制作实战

动画与切换效果编程

问题

动画编程模型概览

添加进入动画

强调与退出动画

触发器控制

多动画时间轴编排

幻灯片切换效果

动画效果参数配置

完整示例：综合动画演示

注意事项